WikiJournal/Back end development: Difference between revisions

Revision as of 05:59, 14 March 2023

Revision as of 06:23, 14 March 2023

Line 1:

{{WikiJ top menu}}

These are short '''user stories''' based on the [[:en:Agile software development|Agile software development]] format to accompany the [[WikiJournal/Technical wishlist|WikiJournal technical wishlist]]. Many pertain to manual processes described in the current [[wikiti:WikiJournal_User_Group/Editorial_guidelines|editorial guidelines]]. Additional stretch goals also included that would be valuable.

== Process and things needed to link ==

Line 11:

[[File:OJS-WikiJournal design item 03.png|thumb|Existing contributor information pulled from and deposited into wikidata.]]As an author, I want to be able to submit an article that I wrote in wikimarkup to a WikiJournal and have its peer review organised.

#The author knows the journal they want to submit to, and goes to its submission page (in Wikimedia) and starts drafting article on wikimedia page

#Author sees "add/edit author data" link on wikimedia page and is taken to OJS page where they can enter metadata (''without'' ''yet'' submitting for review)

#*The author is asked to log in or create a profile in OJS, so they fill out the form to create a new user account.

#*Ideally*''Stretch:'' can use Wikimedia OAuth login on OJS

#*Ideally*''Stretch:'' existing author profile information pulled from wikidata into new OJS profile

#*Ideally:*New newOJS author profile information deposited from OJS to wikidata (with informed consent)

#*OJS creates new item for draft and associates it with the corresponding mediawiki page and wikidata item

#*Author can enter metadata about the article in OJS (authors, affiliations, contact, keywords), ''without'' ''yet'' submitting for review

#*''Stretch:'' When the author is adding contributors:

#**Existing contributor information pulled from wikidata into OJS

#**New contributor information deposited from OJS to wikidata (with informed consent)

#There, the author is asked to log in or create a profile in OJS, so they fill out the form to create a new user account.

#Wikidata item for draft created and populated with metadata from OJS

#*Ideally: can use Wikimedia OAuth login on OJS

#*If meta data in OJS updated, corresponding Wikidata item is updated

#*Ideally: existing author profile information pulled from wikidata into new OJS profile

#*Ideally: new author profile information deposited from OJS to wikidata (with informed consent)

#Wikidata item for draft created from OJS

#Wikidata item for draft updated from OJS if data in OJS updated

#Author is not yet ready to submit draft so saves author info at OJS and clicks link to be taken back to draft on mediawiki

#If author edits draft in wikimedia, they can easily find corresponding OJS page by single click and vice versa

#AuthorLater, the nowauthor considers draft ready for submission and sees a "Submit" link on mediawiki, clicks it, and is taken to the articledraft's OJS page.

#Author submits the article (having already filled in author metadata etc previously)

#Process proceeds as above

''Stretch goal:'' As an author, I want to be able to submit an article that I wrote as a ''docx/gdoc/latex'' to a WikiJournal, so that it will be converted into wikimarkup and have its peer review organised.

# The author knows the journal they want to submit to, and goes to its submission page (in Wikimedia) ([[wikiversity:WikiJournal_of_Science/Submission|example]])

Line 27 ⟶ 33:

#Author given option to upload article as docx/gdoc/latex. Document is converted to wikimarkup and saved to wikimedia page (pandoc?)

#Author given option to check and copyedit draft article on Wikimedia page

#Steps then proceed as above

#When the author is adding contributors:

#*Existing contributor information pulled from wikidata into OJS

#*New contributor information deposited from OJS to wikidata (with informed consent)

#If author edits draft in wikimedia, they can easily find corresponding OJS page by single click and vice versa

#Wikidata item for submission created from OJS

#Wikidata item for submission updated from OJS if data in OJS updated

=== Initial checks ===

[https://www.youtube.com/watch?v=_t7Q7iH59xI&list=PLg358gdRUrDUH0A7bCsDhpfgFKzq5Xl8T&index=4 OJS process] | [[wikiversity:WikiJournal_User_Group/Editorial_guidelines#Plagiarism_checking|WikiJournal process]]

Line 89 ⟶ 90:

#Handling editor can nominate backup potential peer reviewers in OJS to be contacted if initial ones decline / don't respond after certain time

#When emails sent out to potential reviewers, the wikimedia page is converted to a PDF and attached

#

#

=== Receive reviews ===

Line 101 ⟶ 99:

# Reviewer creates OJS user account

# Reviewer submits freetext comments in OJS (ideally in wikimarkup formatting) and optionally, attaches pdf

# Wikidata item for draft updated frommetadata OJSabout ifpeer datareviews infrom OJS updated

As handling editor, I want to know when peer reviews are submitted and whether the reviewer has made their identity public

Line 163 ⟶ 162:

==== Submission ====

As an author, I want to be able to submit an article that I wrote in [[v:WikiJournal Preprints|WikiJournal Preprints]], so that it will have its peer review organised.

As an author, I want to be able to submit an article that I wrote as a docx/latex to a WikiJournal, so that it will be converted into wikimarkup and have its peer review organised.

As an author of a Wikipedia article, I want to be able to submit that article to a WikiJournal, so that it will have its peer review organised.

As an author of a previously published WikiJournal article, I want to be able to edit a copy of that article and re-submit it, so that the updated version will have its peer review organised.