Skip to content

Commit

Permalink
Update contribution guide
Browse files Browse the repository at this point in the history
  • Loading branch information
kdeldycke committed Dec 11, 2023
1 parent 59a070f commit c97bfeb
Showing 1 changed file with 11 additions and 7 deletions.
18 changes: 11 additions & 7 deletions .github/contributing.md
Original file line number Diff line number Diff line change
Expand Up @@ -46,17 +46,19 @@ That way we can put back tables in place. `┬─┬ γƒŽ( γ‚œ-γ‚œγƒŽ)`
Data models and structures generic enough to cover and address most of the
falsehoods are also welcome in this page.

## Pull-Request and Issue
## Pull-requests and issues

- Search past and current issues and pull-requests for previous suggestions before making a new one, as yours may be a duplicate or a work in progress.
- Search past and current issues and pull-requests for previous suggestions before making a new one. Yours may be a duplicate or a work in progress.

- Only one list item per commit.

- Only one commit per pull-request. Always squash commits after applying changes.

- Check your spelling and grammar.

- Add the reason why the linked resource is awesome. And what it adds to existing content.
- Add the reason why the linked resource is awesome. And what it adds to the existing corpus.

- Keep the translated content up-to-date with your proposal. Propagate changes to all `readme.*.md` files. Rely on automatic translation tools. Bilingual contributors will refine the result later.

## Linting

Expand Down Expand Up @@ -87,7 +89,7 @@ If one of these rule conflict with the linter, the linter's rule should takes pr

- Try to quote the original content as-is to summarize the point of the linked content.

- If a straight quote doesn't cut it, feel free to paraphrase both the item's title and description. Remember, this is curation: we are increasing the value of the original content by aggregation and categorization, yes, but also by smart editorializing. As long as you respect the spirit of the original content it's OK.
- If a straight quote doesn't cut it, feel free to paraphrase both the item's title and description. Remember, this is curation: we are increasing the value of the original content by aggregation and categorization. And also by smart editorializing. You just need to respect the spirit of the original content.

### Sections

Expand All @@ -99,7 +101,7 @@ If one of these rule conflict with the linter, the linter's rule should takes pr

- Link title must be stripped out of the "*Programmers believe*" part to keep it compact.

- URL must use HTTPs protocol if available.
- URLs must use HTTPs protocol, if available.

- No `β€œ` and `”` curved quotation marks. This is reserved for original content quotation in descriptions.

Expand All @@ -115,9 +117,9 @@ If one of these rule conflict with the linter, the linter's rule should takes pr

- To serialize a list into a description, use the following format:

> This is my own description. Here is a list quoted from the original content about **β€œa random subject: 1. Blah blah blah; 2. Blah blah blah? 3. Blah blah blah.”** This makes sense right?
> Text of a description summarizing the item. And here is a list coming from the original content about **β€œa random subject: 1. Blah blah blah; 2. Blah blah blah? 3. Blah blah blah.”** And a bit more text to conclude.
This provides visual anchor points that help readability and quick content scanning.
This format provides visual anchor points that help readability and quick content scanning.

- You can skip some items from the original list and renumber it.

Expand Down Expand Up @@ -147,3 +149,5 @@ One-liners to fix-up some common formatting mistakes. Use with great caution and
```shell-session
$ sed -i 's/`$/`\./g' ./readme.md
```

[Other one-liners are available](https://kevin.deldycke.com/2006/12/text-date-document-processing-commands/) on my blog.

0 comments on commit c97bfeb

Please sign in to comment.