mkdocs-material/docs
Alexander Voss 2bb907d0d9
Added guide for creating Pull Requests (#6429)
* 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
2023-12-09 22:26:42 +01:00
..
assets Prepare 9.1.12+insiders-4.34.0 release 2023-05-14 18:02:18 +02:00
blog Documentation 2023-11-30 13:30:31 +01:00
changelog Prepare 9.5.1 release 2023-12-08 09:39:09 +01:00
contributing Added guide for creating Pull Requests (#6429) 2023-12-09 22:26:42 +01:00
guides Restructured documentation (#5692) 2023-09-14 19:09:18 +02:00
insiders Updated Insiders changelog 2023-12-08 10:29:59 +01:00
plugins Updated Insiders changelog 2023-12-08 10:29:59 +01:00
reference Documentation (#6459) 2023-12-07 17:20:10 +01:00
schema Updated Insiders changelog 2023-12-08 10:29:59 +01:00
setup Updated Insiders changelog 2023-12-08 10:29:59 +01:00
alternatives.md Fix a few typos 2023-02-16 16:21:11 +01:00
browser-support.md Documentation 2023-09-15 09:25:50 +02:00
conventions.md Documentation (#6331) 2023-11-14 23:04:58 +01:00
creating-your-site.md Documentation 2023-11-16 10:21:46 +01:00
customization.md Documentation 2023-10-16 18:36:10 +02:00
enterprise-support.md Documentation 2023-11-17 09:43:30 +01:00
getting-started.md Documentation (#6222) 2023-10-30 21:14:42 +01:00
index.md Override social card title 2023-09-12 13:37:22 +02:00
license.md Updated copyright year 2023-01-02 11:08:58 +01:00
philosophy.md Restructured documentation (#5692) 2023-09-14 19:09:18 +02:00
publishing-your-site.md Updated publishing-your-site.md (#6335) 2023-11-14 23:01:25 +01:00
schema.json Added new MkDocs 1.5 settings to JSON schema 2023-10-05 19:16:54 +02:00
upgrade.md Documentation 2023-09-20 14:03:28 +02:00