Merge pull request #46 from NixOS/master

Issue 2018/02

CfC.rst

@@ -0,0 +1,21 @@
+NixOS Weekly Newsletter: Call for Content
+=========================================
+
+Dear friends
+
+The next issue of the NixOS "Weekly" newsletter is coming up!
+I am collecting content and you are invited to submit topics for inclusion.
+
+- To be published [[[FIXME: set the date]]]
+- Submissions accepted until [[[FIXME: set the date]]]
+- How:
+  - submitting a comment on GitHub at [[[FIXME: LINK to Pull Request]]].
+  - responding to this email.
+
+
+You may view the current draft at http://weekly.nixos.org/preview
+
+Thank you!
+
+
+[[[FIXME: YOUR NAME]]]

EDITORS.rst

@@ -0,0 +1,96 @@
+Welcome
+=======
+
+Thank you for helping edit the NixOS "Weekly" Newsletter!
+
+
+Requirements
+============
+
+You'll need the following in order to work through the pipeline:
+
+- Git.
+- Nix.
+- Push permissions to `master` and `production` branches of this
+  repository.
+
+  Please ask if you don't have this already. You can create a ticket
+  on GitHub or ping `#nixos` on IRC.
+
+- Mailchimp account to send the newsletter.
+
+
+Responsibilities
+================
+
+Core responsibilities are to:
+
+#. Decide on a publish date.
+#. Initiate and format the next edition of the newsletter.
+#. Send out a call for contributions.
+#. Field the suggestions and incorporate them
+#. Optionally add a brief intro and outro.
+#. Have fun!
+
+
+Some Notes
+==========
+
+- Contributor status
+
+  Ideally you should be able to push to the `master` and `production`
+  branches of this repository.
+
+- `master` branch is for development
+
+  Travis is setup to publish changes on master to http://weekly.nixos.org/preview
+
+
+
+Creating a new post
+===================
+
+#. Copy `template.rst <./template.rst>`_ to ``content/<year>/<number>-<title>.rst``
+
+#. Create a pull request from `master` to `production`.
+
+   Changes will be visible at http://weekly.nixos.org/preview
+
+#. Make changes
+
+   You can preview the site locally while editing by running:
+
+   ::
+
+      nix-shell --command "python run.py
+
+   This will serve on `http://127.0.0.1:5500 <http://127.0.0.1:5500>`_ and automatically
+   refresh on changes.
+
+4. Ask for contributions.
+
+   You can send an email to `nix-devel@googlegroups.com <mailto:nix-devel@googlegroups.com>`_.
+   There's a template in `./CfC.rst <./CfC.rst>`_.
+
+   Historically, the pull-request has been where contributions have
+   been made.
+
+5. Publish by merging into ``production`` using a merge commit.
+
+6. Send the email. FIXME: not sure how yet, more to come
+
+
+Troubleshooting
+===============
+
+Ideally everything will just work, but in the rare cases of trouble,
+here is a runbook.
+
+- Merging to `production` fails CI FIXME: get more info, link to ticket
+
+  There's a bug in `.travis.yml` causing merges to `production` to
+  fail.
+
+
+Please do create a ticket when something breaks, we want this to be as
+straightforward as possible.

README.rst

@@ -32,6 +32,7 @@ Ways to contribute:
   role is that blog post release happens on time and that we have an editor for
   next release. To become and editor all you have to do is volunteer.
 
+  See `EDITORS.rst <./EDITORS.rst>`_
 
 FAQ
 ---

content/2018/02-life-before-death.rst

@@ -0,0 +1,210 @@
+#02 - Life before death, strength before weakness, ...
+######################################################
+
+:date: 2018-02-01
+:description: ... journey before pancakes.
+              (Brandon Sanderson, Oathbringer)
+
+
+.. -----------------------------------------------------------------------------
+.. (OPTIONAL) Introduction text, as an editor this is your space to express
+   opinions
+.. -----------------------------------------------------------------------------
+
+Welcome to another edition of NixOS "Weekly" News -- we're still
+working on that weekly bit and I've half a mind to amend the quote to
+add "monthly before weekly".
+
+Let me start by addressing everyone who helped put this edition
+together: By creating the content and helping collect items, you make
+the newsletter possible. Thank you.
+
+Contributions for future editions are more than welcome.
+One way to help is by editing a release; we've added an `Editor's Guide`_ to help you.
+
+There are some exciting things happening in the community, and I hope you'll agree.
+
+
+
+.. _`Editor's Guide`: https://github.com/NixOS/nixos-weekly/blob/master/EDITORS.rst
+
+
+.. -----------------------------------------------------------------------------
+.. News - Special items that happen in community
+.. -----------------------------------------------------------------------------
+
+News
+====
+
+.. - Example news item title `with link`_
+..
+..   News item description (optional)
+..
+.. .. _`with link`: http://example.com
+
+
+- `Nix 2.0 is coming`_
+
+  This includes `renaming Nix 1.12 to 2.0`_
+
+  Relevant are Eelco's `slides fron NixCon`_ and `associated talk`_ about the changes.
+
+- Google Summer of Code is coming up
+
+  ...and looking for mentors. Please submit PRs at `GSoC 2018 project ideas`_.
+
+
+- `Seeking maintainer for mvn2nix-maven-plugin`_
+
+
+- `NixOS Vagrant box updated to 17.09`_
+
+- `Pure evaluation mode added to Nix unstable`_
+
+
+.. _`GSoC 2018 project ideas`: https://github.com/nix-community/google-summer-of-code
+.. _`Seeking maintainer for mvn2nix-maven-plugin`: https://groups.google.com/forum/#!msg/nix-devel/yNpZaugzKiE/nrGP3by3AgAJ
+.. _`NixOS Vagrant box updated to 17.09`: https://app.vagrantup.com/nixos
+.. _`Pure evaluation mode added to Nix unstable`: https://github.com/NixOS/nix/commit/d4dcffd64349bb52ad5f1b184bee5cc7c2be73b4
+.. _`Nix 2.0 is coming`: https://github.com/NixOS/nix/issues/1806#issuecomment-362062346
+.. _`renaming Nix 1.12 to 2.0`: https://github.com/NixOS/nix/commit/c287d7312103bae5e154c0c4dd493371a22ea207
+.. _`slides fron NixCon`: https://schedule.nixcon2017.org//system/event_attachments/attachments/000/000/004/original/talk.pdf?1509289391
+.. _`associated talk`: https://www.youtube.com/watch?v=XVIKScU7Uf4&index=4&list=PLgknCdxP89ReQzhfKwMYjLdwWsc7us8ns
+
+.. -----------------------------------------------------------------------------
+.. Jobs - list of available Nix related jobs
+.. -----------------------------------------------------------------------------
+
+
+Jobs
+====
+
+.. - `Example job posting`_
+..
+.. .. _`Example job posting`: http://example.com
+
+
+- `Serokell is hiring Nix DevOps Engineers`_
+
+.. _`Serokell is hiring Nix DevOps Engineers`: https://gist.github.com/NaeosPsy/155f76a25e0c93eb067a0f4d86dd8cfc
+
+
+
+.. -----------------------------------------------------------------------------
+.. Reading - List of blog posts, collected (hopefully) via planet.nixos.org
+.. -----------------------------------------------------------------------------
+
+Reading
+=======
+
+.. - `Example blog post title`_
+..
+..   optional extra description
+..
+.. .. _`blog post title`: http://example.com
+
+
+- Danial Barlow is developing NixWRT [#fnixwrt]_
+
+  - `nix-devel NixWRT discussion`_
+  - `Baud Games blog post`_
+
+- `Stackage nixpkgs overlays`_ by Dmitry Bushev
+
+- `Syntax highlighting Nix expressions in mcedit`_ by Sander van der Burg
+
+- `Diagnosing problems and running maintenance tasks in a network with services deployed by Disnix`_ by Sander van der Burg
+
+- `OneDrive on NixOS using Docker`_ by  Nathan Bijnens
+
+- (French) `Journal le "style fonctionnel" en vidéos (Nix, NixOS, Haskell)`_
+  (Video_, Code_) by nokomprendo
+
+- `Linux Distributions, Part 1: NixOS`_ by Guillaume Salvan
+
+- `Introduction to NixOS`_ by @hackoflamb
+
+- `Provisioning a NixOS server from macOS`_ by `zw3rk`_
+
+- `Installing NixOS`_ by Andrew McCluskey
+
+
+.. [#fnixwrt] described as "won't be big or professional like OpenWRT"
+.. _`nix-devel NixWRT discussion`: https://groups.google.com/forum/#!topic/nix-devel/zDQH7Ulotoc
+.. _`Baud Games blog post`: https://ww.telent.net/2018/1/7/baud_games
+.. _`Stackage nixpkgs overlays`: https://blog.typeable.io/posts/2018-01-19-stackage-overlay.html
+.. _`Syntax highlighting Nix expressions in mcedit`: http://sandervanderburg.blogspot.com.es/2018/01/syntax-highlighting-nix-expressions-in.html
+.. _`OneDrive on NixOS using Docker`: https://nathan.gs/2018/01/09/onedrive-on-nixos-using-docker/
+.. _`Journal le "style fonctionnel" en vidéos (Nix, NixOS, Haskell)`: https://linuxfr.org/users/nokomprendo-3/journaux/le-style-fonctionnel-en-videos-nix-nixos-haskell
+.. _`Video`: https://www.youtube.com/watch?v=i6s-G_Hh3s4&list=PLe8vnuC2T7iGE3w_d-MCHw5mLzRAMiCM9
+.. _`Code`: https://github.com/nokomprendo/tuto_fonctionnel
+.. _`Linux Distributions, Part 1: NixOS`: https://guillaumesalvan.github.io/linux/nixos/2018/01/16/nixos.html
+.. _`Introduction to NixOS`: https://stelligent.com/2017/07/11/introduction-to-nixos/
+.. _`Provisioning a NixOS server from macOS`: https://medium.com/@zw3rk/provisioning-a-nixos-server-from-macos-d36055afc4ad
+.. _`zw3rk`: https://medium.com/@zw3rk
+.. _`Installing NixOS`: https://qfpl.io/posts/installing-nixos/
+.. _`Diagnosing problems and running maintenance tasks in a network with services deployed by Disnix`: http://sandervanderburg.blogspot.com/2018/01/diagnosing-problems-and-running.html
+
+
+.. -----------------------------------------------------------------------------
+.. Tooling - List of useful tools (or their updates)
+.. -----------------------------------------------------------------------------
+
+Tooling
+=======
+
+.. - `Example tool with a link to it`_
+..
+..   Description what tool does, why it was created, or what is new since last
+..   time.
+..
+.. .. _`tool name with a link to it`: http://example.com
+
+
+- `nixos/nixos-hardware`_
+
+  A collection of NixOS modules covering hardware quirks.
+
+  The respository has been seeing a lot of work being done in last months
+  leading by `@yegortimoshenko`_ (Yegor Timoshenko).
+
+  Check it out and contribute your own ``hardware-configuration.nix``
+
+- `nixos-mailserver`_
+
+  A complete and Simple Nixos Mailserver 
+
+.. _`nixos/nixos-hardware`: https://github.com/NixOS/nixos-hardware
+.. _`@yegortimoshenko`: https://github.com/yegortimoshenko
+.. _`nixos-mailserver`: https://github.com/r-raymond/nixos-mailserver
+
+
+.. -----------------------------------------------------------------------------
+.. Events / Meetups - regular or one time announcements of FUTURE events
+.. -----------------------------------------------------------------------------
+
+..
+   Events / Meetups
+   ==================
+
+.. - Example event title `with link`
+..
+..   Event description
+..
+.. .. _`with link`: http://example.com
+
+
+.. -----------------------------------------------------------------------------
+.. TODO: this should be part of the article template, but we need to change old
+         articles once this is moved into article template
+.. -----------------------------------------------------------------------------
+
+Contribute
+==========
+
+You can help shape NixOS Weekly Newsletter too! Create or comment on the `pull
+request`_ for the next edition or loot at the `issue tracker`_ to add other
+improvements.
+
+.. _`pull request`: https://github.com/NixOS/nixos-weekly/pulls
+.. _`issue tracker`: https://github.com/NixOS/nixos-weekly/issues