documentation.federated.com.../content/en/docs/contribution_guidelines/_index.md

30 lines
1.5 KiB
Markdown
Raw Permalink Normal View History

2023-05-30 17:55:11 +00:00
---
title: "Contribution Guidelines"
linkTitle: "Contribution Guidelines"
weight: 10
description: >
2023-06-02 14:24:42 +00:00
How to contribute to the Federated Core documentation.
2023-05-30 17:55:11 +00:00
---
{{% pageinfo %}}
2023-06-02 14:24:42 +00:00
This documentation is create using Docsy and Hugo and then pushed to a Gitea repository on our Federated Core. A webhook in Gitea then pushes the public folder to Caddy where it is published to the world-wide-web.
2023-05-30 17:55:11 +00:00
{{% /pageinfo %}}
2023-06-02 14:24:42 +00:00
We use [Hugo](https://gohugo.io/) to format and generate our website, and publish it through [Gitea]() running on our Federated Core. This documentation is created used the [Docsy]() template.
2023-05-30 17:55:11 +00:00
Hugo is an open-source static site generator that provides us with templates,
content organisation in a standard directory structure, and a website generation
engine. You write the pages in Markdown (or HTML if you want), and Hugo wraps them up into a website.
All submissions, including submissions by project members, require review. We
2023-06-02 14:24:42 +00:00
use Gitea pull requests for this purpose.
2023-05-30 17:55:11 +00:00
2023-06-02 14:24:42 +00:00
### If you would like to contirbute
2023-05-30 17:55:11 +00:00
2023-06-02 14:24:42 +00:00
Please send an email to support@federated.computer with your interest to contribute to the documentation. If we decide to collaborate, we are willing to compensate you for your contributions with free Federated services, merchandise, even BTC. Please get in touch.
2023-05-30 17:55:11 +00:00
2023-06-02 14:24:42 +00:00
### Useful resources
2023-05-30 17:55:11 +00:00
* [Docsy user guide](https://www.docsy.dev/docs/): All about Docsy, including how it manages navigation, look and feel, and multi-language support.
* [Hugo documentation](https://gohugo.io/documentation/): Comprehensive reference for Hugo.