Skip to content

Community-managed blog for all things open source. Contributions accepted.

License

Notifications You must be signed in to change notification settings

doubledotlabs/Blog

Repository files navigation

This blog, hosted by Double Dot Labs, exists as a centralized collection for documenting anything and everything that exists in open source software.

Freenode IRC channel. Twitter account. CLA assistant.

Contributing

We encourage others to contribute to this collection. This repository is published under the public domain and is open to any kind of positive contribution, including new contributions, spelling / grammar fixes, suggestions for more articles, and more.

You do not have to be a member of Double Dot Labs to contribute to this project. Double Dot Labs is a community that strives to improve Open Source and enable healthy collaboration between individuals. You can find more community resources, such as our code of conduct and license agreements, in the DoubleDotLabs/Community repository.

Adding New Articles

To contribute an article to this collection, first fork this repository.

Next, create a markdown file in the forked repository named with the format {year}-{month}-{day}-{title}.md.

In order for your article to show up on the site, it will need to have a front matter. To properly index your article, copy the text below to the top of the file, replacing the required metadata where necessary. Each submission must have a minimum of one tag, one author, and one citation.

For a list of available tags, see the files in this directory. If there is a tag missing that you believe would be beneficial to the collection, please create a new issue with the title "New tag: {tag name}" explaining why it should be added. It doesn't have to be long, just as long as it demonstrates that the tag has a specific purpose; it is not directly related to a specific organization or project, but is more specific than something like messaging, which can have more than one meaning (e.g. text messaging / social networks, firebase cloud messaging / server technology).

---
layout: blog
title: "Post Title"
description: "A short 1-2 sentence description of your article."
tags:
  - a
  - bunch
  - of
  - relevant
  - tags
author: "Primary Author / Group Name"
authors:
  - name: "Author Name"
    url: https://example.com/
    avatar: https://example.com/avatar.png
citations:
  - name: "Citation Name"
    url: https://example.com/
---

Place your article text below this front matter, formatted in Markdown styling. GitHub-flavored markdown is partially supported.

For various reasons, any articles about excessively controversial or political topics will not be accepted. Once your article is finished, you will need to agree to the Contributor License Agreement, then you may create a pull request to have it reviewed and added to this collection. You must have explicit permission from all authors of an article in order to contribute it to this blog.

Improving Existing Articles

There are not many requirements for modifying an article that has already been accepted. You will still need to agree to the Contributor License Agreement, then you may simply create a pull request stating the reasons for you change and it will be reviewed and (hopefully) merged accordingly. You may add yourself to the list of authors in the metadata if you wish (provided that this is not your sole reason for contributing).

Indexing Published Articles

In the event that you do not want to go through the effort of reformatting an already-written article to publish on this blog, do not want to attribute your work to the public domain, or want to host the article on your site for other reasons, you can still index your article here! Simply create a markdown file like above but without any actual content, and use the following template in place of the metadata (the redirect attribute should contain a URL to your article):

---
layout: redirect
redirect: https://example.com/
title: "Post Title"
description: "A short 1-2 sentence description of your article."
tags:
  - a
  - bunch
  - of
  - relevant
  - tags
author: "Primary Author / Group Name"
authors:
  - name: "Author Name"
    url: https://example.com/
    avatar: https://example.com/avatar.png
---

The same as adding a complete article to this site, you must have permission from the author of the article before it can be added to this blog.

License

Content in this repository is dedicated to the public domain under the CC0. By contributing to this repository, you relinquish any copyright ownership to the contributed material. A copy of the CC0 license is provided here.

To the extent possible under law, Double Dot Labs Blog contributors have waived all copyright and related or neighboring rights to this work.

Creative commons license button.

Releases

No releases published

Packages

No packages published