[x] Choose a task with a blank phase column from tasks and check that it appears to be a valid task entry, e.g., it has a link to a paper and a name , etc., Change the phase column to 1 in that sheet and add your github username to the phase 1 editor column.
[x] Name the issue as the name of the task.
[x] Create the issue and assign yourself.
[x] Read the linked paper and search through any associated documents or references to find a root source of the task. If there is not enough information to document the task and you must email the authors, add comments to this issue documenting that process.
[x] Make a new branch named the task name and create a new file in the folder tasks named {task name}.md. Start by populating it with the content of task-template.md. When saving this, be sure to commit to your new branch (if you're in master you won't be able to commit and only be able to create a pull request, instead, do this from your branch so you can commit).
[x] Add images to the /images folder in the task branch and to the text with the format ![Alt text](/images/full_task_name_image_number.jpg). Use underscores _ instead of spaces in the image name, otherwise they will not work reliably.
[x] Add a pull request (PR) between your new branch and master with the name {task name} and the url for this issue in the PR message. If you realize you need to make more changes to task files you can commit them to the task branch and the pull request should update automatically.
[x] Get the URL to the main file in your branch and put it in the tasks sheet in the task summary url column.
Second pass (a different person does this)
[x] Add yourself as a secondary assignee to the issue. Also, on the tasks sheet, change the phase column to 2 in that sheet and add your GitHub username to the phase 2 editor column.
[x] Read the paper and search through any associated documents or references to find a root source of the task.
[x] Check the PR, making modifications wherever you see necessary to ensure that the task is adequately documented.
[x] Check that the template renders correctly by previewing and making any necessary adjustments.
[x] Submit a passing review, update the issue, and move on to the next steps.
Task mapping (do this after all previous sections are completed)
[x] First pass assignee: Complete the task mapping survey entering your GitHub username as the user name, and the task file name as the task name.
[ ] Second pass assignee: Complete the task mapping survey entering your GitHub username as the user name, and the task file name as the task name.
[ ] Both assignees: meet to review the agreement page, selecting this task.
[ ] First pass assignee: In a second browser window start a new task mapping survey, this time entering the first then second assignee's GitHub usernames separated by |, e.g., markwhiting | djwatts, and the task file name as the task name.
[ ] Fill in all the agreed responses, and the resolved conflicts.
Wrapping up (do this after all previous sections are completed)
[ ] Merge the PR, if you see options to also delete the associated fork, do that too.
[ ] Get the URL to the file in master/tasks and replace the link in the tasks sheet task summary url column.
Instructions
First pass
phase
column from tasks and check that it appears to be a valid task entry, e.g., it has a link to a paper and a name , etc., Change thephase
column to1
in that sheet and add your github username to thephase 1 editor
column.tasks
named{task name}.md
. Start by populating it with the content of task-template.md. When saving this, be sure to commit to your new branch (if you're in master you won't be able to commit and only be able to create a pull request, instead, do this from your branch so you can commit)./images
folder in the task branch and to the text with the format![Alt text](/images/full_task_name_image_number.jpg)
. Use underscores_
instead of spaces in the image name, otherwise they will not work reliably.master
with the name{task name}
and the url for this issue in the PR message. If you realize you need to make more changes to task files you can commit them to the task branch and the pull request should update automatically.task summary url
column.Second pass (a different person does this)
phase
column to2
in that sheet and add your GitHub username to thephase 2 editor
column.Task mapping (do this after all previous sections are completed)
|
, e.g.,markwhiting | djwatts
, and the task file name as the task name.Wrapping up (do this after all previous sections are completed)
master/tasks
and replace the link in the tasks sheettask summary url
column.