Successfully reported this slideshow.
Your SlideShare is downloading. ×

Lightning talk how to edit the Silverstripe CMS docs

Ad

Lightning talk: How to edit
the Silverstripe CMS docs
Presented by – Michael Pritchard

Ad

Michael Pritchard
2
• First computer was
a ZX Spectrum 48k
• Twitter:@MikeAPritch
Software developer

Ad

Agenda
3
• What is the problem?
• How to edit one page?

Ad

Ad

Ad

Ad

Ad

Ad

Ad

Ad

Ad

Ad

Ad

Upcoming SlideShare
Sculpin
Sculpin
Loading in …3
×

Check these out next

1 of 14 Ad
1 of 14 Ad

Lightning talk how to edit the Silverstripe CMS docs

Download to read offline

Lightning talk from StripeConEU 2021, how to edit the Silverstripe CMS docs by clicking the link in the docs, editing the document on GitHub and submitting a pull request.

Lightning talk from StripeConEU 2021, how to edit the Silverstripe CMS docs by clicking the link in the docs, editing the document on GitHub and submitting a pull request.

More Related Content

Lightning talk how to edit the Silverstripe CMS docs

  1. 1. Lightning talk: How to edit the Silverstripe CMS docs Presented by – Michael Pritchard
  2. 2. Michael Pritchard 2 • First computer was a ZX Spectrum 48k • Twitter:@MikeAPritch Software developer
  3. 3. Agenda 3 • What is the problem? • How to edit one page?
  4. 4. What is the problem? 4 What we could do better Documentation is still a common thread in the responses about what we could do better. This is an open source project and we do encourage in particular the long-standing community members to share their knowledge by improving our docs. Rounding up the 2020 Community Survey https://www.silverstripe.org/blog/community- survey-results/
  5. 5. Requirements 5 • Markdown • GitHub account
  6. 6. How to edit a page 6
  7. 7. Amend 7 https://learnxinyminutes.com/docs/markdown/
  8. 8. Preview 8
  9. 9. Fill in the Title DOC: … 9
  10. 10. Create pull request 10
  11. 11. CI will automatically run 11
  12. 12. Full documentation 12 https://docs.silverstripe.org/en/4/contributing/documentation/
  13. 13. Tip 13
  14. 14. Questions Any questions? 14

Editor's Notes

  • I’ve been interested in software form a young age, when my uncle bought me a ZX Spectrum. I didn’t actually get into software development until much later, only 3 years ago, I installed a software package called REDCap and decided it would be good to learn how to write some code to access the APIs.

    I joined a public sector company (who I can’t name) in July 2021, just are the start of the Covid pandemic, so this is been an interesting year. So I’ve been a professional software developer for 1 year.


  • Silverstripe CMS documentation is a common thread in the responses on what we could do better
  • How anyone can edit the docs

    Knowledge of markdown – PhpStorm and VS Code have markdown editors either built in or as a downloadable plugin

    GitHub account
  • How anyone can edit the docs

    If you spot something which is not right on in the docs, they can be edited.

    Click the GitHub logo in the top right corner of the page

    When GitHub navigate to docs > en >Section > the document

    Click the pencil icon to edit the page in GitHub.
  • The markup is called Markdown, it is intended to be easy to read by humans, for the list of available syntax see: learn x in y minutes.com/docs/markdown/
  • Once the page has been edited, check the preview.
  • Scroll to the bottom, for the title needs to start DOC followed by a description of your change

    For more details you can fill in the optional extended description.

    Click propose changes.

    A pull request will be created and submitted to Silverstripe for approval
  • Create a pull request

    Then Create pull request once more

  • CI checks will automatically start.

    Note there are no conflicts with this base branch.

    Now you have to wait for the PR to be approved
  • For the full Silverstripe CMS documentation see https://docs.silverstripe.org/en/4/contributing/documentation/
  • If you have previously forked from the repository, then it's a good idea to click “fetch upstream” and “fetch and merge” before you make any further changes.

    If you do not do this you will have to squash your new brunch and resolve any conflicts.
  • Questions?

×