desilinguist / this-week-in-neovim-contents

Contents of weekly news delivered by this-week-in-neovim.org.

This Week In Neovim | Contents

This repository holds the contents of https://this-week-in-neovim.org.

Organization

News are classified by year, month, and day. The file naming scheme is quite simple /contents/<year>/<month>/<day>.md. For instance:

contents/
  |
  + 2021
  |  |
  |  + …
  |
  + 2022/
      |
      + Jul
      |  |
      |  + 15.md
      |  |
      |  + …

An important notice about formatting: both the year and the day are numerals (2022, 15) but the month is not. So you have to use Jul instead of 06. This is the case for all the months and the rule is simple: take the name of the month, keep only the first three characters and use an uppercase for the first one. December -> Dec, August -> Aug, etc.

At the very beginning of a weekly cycle, a new default Markdown file for the week is created and pushed to a branch %Y-%M-%d. PR are accepted and must target that branch. Notice that the file is dated (year, month, day), and then we expect a release to be done on that day. If for whatever reason we can’t make it, we will not change the branch name, but we will update the file eventually.

Before the end of the cycle, around Sunday or Monday, a PR is opened to merge %Y-%M-%d -> master. Everyone can partake in that phase of review, but the goal here is to ensure links work, no typo are present, etc., or if anyone want to withdraw their updates from the weekly updates.

To finish the cycle, the merge commit is created and the article is automatically available on https://this-week-in-neovim.org/latest or https://this-week-in-neovim.org///.

How to contribute?

If you want to become a content contributor, you can do different things, but there are some general rules to follow:

1. Always read the current %Y-%M-%d branch (and PRs targetting it) to ensure no one has come up with the same news as you yet.
2. Open a PR against %Y-%M-%d branch by adding new stuff you’ve seen.
3. Ensure your contribution is devoid of bad language and goes straight to the point. See the section about how to contribute actual news here.
4. Wait for someone to review and merge your contribution.
5. Your news will be added to master at the end of the cycle.

If the branch is not created yet, you can even contribute that branch!

1. Create the %Y-%M-%d branch. You can use the date command to generate that name (assuming you are rebased on origin/master, fully fetched): git switch -c $(date +%Y-%M-%d).
2. Copy the file news-template.md in contents/<year>/<month>/<day>.md.
3. Open the PR.

How do you write a news PR?

When opening a PR to add some news to the next weekly, you must always include the following elements:

• The source of the news. It can be a commit on GitHub, a changelog, a blog article, etc. anything, but you must provide a link. A chat discussion is not considered “a valid source of information” if we can’t link back to it. The goal is to write a list of news, with a link to the actual news so that readers can read further more if they want to.
• A super short description of the change. For instance, “some-plugin.nvim: add new feature to sort files by size.”.
• If the news is visual, you are strongly advised to upload some screenshots to GitHub (open an issue, slide the image, get the link and simply close your issue tab, do not actually create the issue). Do not put images in your PRs as they will be automatically refused. If you don’t want to use GitHub, that’s fine, but ensure to use an image provider that will remain stable in time.

Each news should be a simple listed item of the form:

- _Few words explaining the change_: a longer description ([source](link-to-source)).