* added tutorials page and blog tutorial
* proof reading, some language improvements
* split blog tutorial into parts
and reworked on the basis of comments, improved language, added missing
things
* + custom slugify function example
* +blog tutorial on engagement
* + section blog ToC
* + instructions for X/FB share buttons and started discussion system
* fix: module name `code` shadowed Python standard library module
* added What's next section
* +blog tutorial engagement part
* fix: updated Giscus code snippet
* trying multiple tutorials with headings for each group
* + basic social cards tutorial
* + custom social card tutorial
* + estimated time for custom card tutorial
* added tutorial sections to nav
* fixed typos, removed sponsor icon from level one heading
* removed "tutorial" from level one heading
* added headings to custom layout example
* fixed broken link
* fixes after run-through, added links to template repos
* added comment for @squidfunk
* clarified use of logos, some proof-reading
* removed question I left for @squidfunk
* clarified relationship between background color and image
* added override for the background image
* fixed wording and indentation
* changed example to be releases, not events
* being more specific where to add the last bit of code in the layout
---------
Co-authored-by: squidfunk <martin.donath@squidfunk.com>
* added first draft of instructions for pull requests
* added a diagram to explain process
* added description of the process, moved specific instructions
- split the diagram into two parts to easy comperehension and
allow people to better follow the process
- added descriptions of the conceptual steps, keeping them
separate from specific instructions
- moved the specific instructions under a common heading to make
the ToC more readable
* added explanations
- added link to GitHub docu on forks
- added note on philosophy followed
- improved ToC structure
* tried to finalize process description (see below)
- added airline-style "pay attention to the instructions" tip
- added bit about testing with Material for MkDocs documentation
and examples from the examples repo
- added note on being respectful in discussion and on how sometimes
PRs do not get accepted for good reason
- improvements for readability
* moved the "philosophy" bit to the steps
IMHO this is a better place to make this point as the comments are
mainly about what tools are used, which is more relevant to the
instructions, not the 30k ft view process
* added more text to steps guidance, dos and don'ts
- added more text to pretty much every section under 'steps'
- added a section with dos and don'ts
- left some questions for @squidfunk to ponder
* addressing first set of comments
* addressed further comments
In particular:
- removed the bits about linters and
- about dealing with merge conflicts
These may perhaps need attention in the future.
* removing question about PR template
* added instructions for checking out specific releases and also moved the bit about $GH_TOKEN to a place above
the pip install instructions
* separated out update instructions, revised git instructions
* bumped version number that insiders is based on
* removed --upgrade from update command
* made insiders changelog a section
* changed instructions for upgrading via git
