The best way to contribute to this book is to issue Pull Request when you spot something wrong.
Imagine that you want to fix a problem in the Morphic chapter. Here is the process:
- Click on this link. https://github.com/SquareBracketAssociates/UpdatedPharoByExample/blob/master/Morphic/Morphic.pier
- Click the button in the top tight, then browse to "Morphic.pier" in your fork.
- To the right of the <Raw/Blame/History> buttons, click the button to edit the file.
- After editing, at the bottom select "Create a new branch for this commit and start a pull request" and enter commit title, comment and new-branch-name to reflect your contribution. Click
- Now looking at "Open a pull request", this is issuing a PR to your own fork. We need to change to the upstream fork. At the top click on "forked from SquareBracketAssociates/UpdatedPharoByExample" .
- Under "Your recently pushed branches" click <Compare & pull request>
- Check...
base fork: SquareBracketAssociates/UpdatedPharoByExample
base: master
head fork: YourName/UpdatedPharoByExample
compare: your new-branch-name
- Review the diff, enter PR title and comment, then click .
There are mods/bundles/packages for text editors, that provide improvements for pillar files editing:
- Emacs: pillar-mode
- Vim: vim-pillar
- TextMate: Pillar.tmbundle
- ATOM: language-pillar