Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Revise documentation of development workflow #53

Merged
merged 4 commits into from
Jul 9, 2015

Conversation

suku248
Copy link
Contributor

@suku248 suku248 commented Jul 1, 2015

  • fix typos
  • minor changes to text structure
  • complete use case "Abigail", which explains best practices for minor changes to documentation

@tammoippen and @jougs please check whether the use case "Abigail" now describes a reasonable workflow for minor changes to documentation in master as well as gh-pages

suku248 added 2 commits July 1, 2015 10:00
- in subsection Clone your fork, do not use bullet points for consistency with following subsection
- fix a few typos
The use case "Abigail" explains best practices for changing a small piece of documentation.
@tammoippen tammoippen added the ZC: Documentation DO NOT USE THIS LABEL label Jul 1, 2015
Use case now advises to:
- select option "Create a new branch for this commit and start a pull request"
- include flag "[ci skip]" in Pull Request title
- add label "documentation"

She adds a comment to the Pull Request explaining the reason for the change.
On the GitHub page of NEST she chooses her personal profile as the target and browses to the file she wants to edit. She clicks the button on the top right corner that allows her to edit this file and then fixes the documentation. Once she is done, she writes a meaningful commit message under "Commit changes" at the bottom of the page and selects the option "Create a new branch for this commit and start a pull request". She types in an appropriate branch name and finally clicks "Commit changes".
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I think you do not mean 'personal profile'. I think what you mean is 'personal fork'?
Something like: "On the GitHub page she navigates to her personal fork of NEST and browses [...]"

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I agree and adapted the text accordingly.

@jougs
Copy link
Contributor

jougs commented Jul 9, 2015

The changes look good to me. +1 and merging. Thanks for the contribution.

jougs added a commit that referenced this pull request Jul 9, 2015
Revise documentation of development workflow
@jougs jougs merged commit ee68873 into nest:gh-pages Jul 9, 2015
@suku248 suku248 deleted the gh-pages branch May 10, 2017 10:35
jougs pushed a commit that referenced this pull request Apr 6, 2018
jougs added a commit that referenced this pull request Jun 10, 2021
Update two uses of "stimulating" to "stimulation".
hakonsbm pushed a commit to hakonsbm/nest-simulator that referenced this pull request Jan 16, 2023
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
ZC: Documentation DO NOT USE THIS LABEL
Projects
None yet
Development

Successfully merging this pull request may close these issues.

3 participants