-
-
Notifications
You must be signed in to change notification settings - Fork 30
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
Converting community-wide-resources to rst #230
Conversation
correcting markdown error
…ommunity-handbook into converting-to-rst
name correction of community-wide-resources
correcting error prevet-prevent
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Hey there! Thanks for making a great start on this!
A few things that you need to factor into this PR before we can merge - these are all documented in the issue - please take the time to read it:
- Please follow our headings syntax, as outlined in the issue description. We don't use over and under headings, only under.
- Please don't touch the .revs folder - if anything they should be deleted. It's the old version control system Grav used, and not the live files.
- You've generated link files but you're not using them properly, please check the docs here: https://sublime-and-sphinx-guide.readthedocs.io/en/latest/references.html#use-the-external-links-extension
- We don't need to use random lines like you've done in the async meetings file on line 5 - they don't serve a purpose, so you can remove them.
- Please check that all links are using the link macro, e.g. on line 59 of the same file there's a link posted.
- Please use ref: or doc: to link to other pages.
- Please use the image markup here: https://sublime-and-sphinx-guide.readthedocs.io/en/latest/images.html#add-images rather than figure.
Let me know if you are stuck with anything!
docs/pages/07.community-wide-resources/.revs/20200310-170715/chapter.rst
Outdated
Show resolved
Hide resolved
...ommunity-wide-resources/02.meetings/12.how-to-prepare-and-run-a-mautic-team-meeting/docs.rst
Outdated
Show resolved
Hide resolved
checking appropriate linking method
return to original format
Hey @RCheesley, sorry for that.
Please review when you can |
added resources section
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
A few changes but mostly the same things:
- Not using camel case in headings
- A file not required
- A missed link macro
I will make a commit to move all the files to the right folder so you don't need to worry about that, and will also write some half-decent onboarding docs on how to write for the docs as I appreciate this is somewhat lacking!
...nity-wide-resources/02.meetings/11.asynchronous-async-meetings/.revs/20200310-170715/docs.md
Outdated
Show resolved
Hide resolved
docs/pages/07.community-wide-resources/.revs/20200310-170715/chapter.md
Outdated
Show resolved
Hide resolved
...ommunity-wide-resources/02.meetings/12.how-to-prepare-and-run-a-mautic-team-meeting/docs.rst
Outdated
Show resolved
Hide resolved
...ommunity-wide-resources/02.meetings/12.how-to-prepare-and-run-a-mautic-team-meeting/docs.rst
Outdated
Show resolved
Hide resolved
...ommunity-wide-resources/02.meetings/12.how-to-prepare-and-run-a-mautic-team-meeting/docs.rst
Outdated
Show resolved
Hide resolved
docs/pages/07.community-wide-resources/03.avoiding-burnout/docs.rst
Outdated
Show resolved
Hide resolved
docs/pages/07.community-wide-resources/03.avoiding-burnout/docs.rst
Outdated
Show resolved
Hide resolved
docs/pages/07.community-wide-resources/03.avoiding-burnout/docs.rst
Outdated
Show resolved
Hide resolved
docs/pages/07.community-wide-resources/04.getting-help-in-a-crisis/docs.rst
Outdated
Show resolved
Hide resolved
corrected link format
…repare-and-run-a-mautic-team-meeting/docs.rst Co-authored-by: Ruth Cheesley <[email protected]>
…repare-and-run-a-mautic-team-meeting/docs.rst Co-authored-by: Ruth Cheesley <[email protected]>
…s.rst Co-authored-by: Ruth Cheesley <[email protected]>
…s.rst Co-authored-by: Ruth Cheesley <[email protected]>
…s.rst Co-authored-by: Ruth Cheesley <[email protected]>
…isis/docs.rst Co-authored-by: Ruth Cheesley <[email protected]>
…repare-and-run-a-mautic-team-meeting/docs.rst Co-authored-by: Ruth Cheesley <[email protected]>
…repare-and-run-a-mautic-team-meeting/docs.rst Co-authored-by: Ruth Cheesley <[email protected]>
…repare-and-run-a-mautic-team-meeting/docs.rst Co-authored-by: Ruth Cheesley <[email protected]>
…repare-and-run-a-mautic-team-meeting/docs.rst Co-authored-by: Ruth Cheesley <[email protected]>
…repare-and-run-a-mautic-team-meeting/docs.rst Co-authored-by: Ruth Cheesley <[email protected]>
corrected heading issue
LMK when you're done @Iqmaa if you'd like me to fix the RST issues/move the directories! |
OK Vale is now happy (I have checked it locally, as the linter is having a problem which I'll try to fix in another PR) - the build is now passing. LGTM! Thanks so much for getting this underway @Iqmaa and for your patience! 🚀 |
Congratulations @Iqmaa, the maintainer of this repository has issued you a holobyte! Here it is: https://holopin.io/holobyte/cm2jppvus101970clbs8yh3l98 This badge can only be claimed by you, so make sure that your GitHub account is linked to your Holopin account. You can manage those preferences here: https://holopin.io/account. |
I'm really grateful for your patience and help @RCheesley, I learnt quite a lot from contributing to this. |
fixed #221
I have been able to convert 'community wide resources' to rst format, excluding the page's metadata