Skip to content

Percona Community repository. Join us on Percona.community and the Percona Forums at forums.percona.com.

Notifications You must be signed in to change notification settings

percona/community

Repository files navigation

Percona Community

We welcome everyone to Percona community for developing, installing, running, optimizing, and learning everything around open source databases and infrastructure.

This is a repository for Community Website. It contains information about Percona community events, activities, and ways you could contribute to Percona open source software and participate in the life of the community.

Website Structure

You can find the following information on the website:

Contributing

If you are ready to step in and contribute to Percona software or this website, you can start with checking out the website section dedicated to contributions. You may also find more technical information in our contribution guidelines.

How to Post an Article

We would love to see more authors of technical content in our Community Blog. We accept any technical posts about databases and open source technologies. Also, we have no requirements for the uniqueness of the article. If your post is published on another resource, you can duplicate it here and get more attention.

We understand that the process may be a bit complicated for you. So you can simply send us your post in PDF/Google Doc/Markdown format by email at [email protected].

Here are the quick steps to publish the post. You can find the detailed description of each step in this article.

The site runs on Hugo engine. It turns Markdown pages into HTML very quickly and easily. We also use GitHub and GitHub Pages for free website hosting.

  • Fork our repository "percona/community" and git clone that fork on your computer. If you just want to make a simple contribution, consider performing a shallow clone instead of a full local clone of the repo. This notably reduces the size of the local repo.
  • (Optional) install Hugo engine
  • Run the Hugo server in the source code folder of the site with the command hugo server -D and open a local copy of the site in your browser at localhost:1313
  • Create a separate branch for your changes.
  • Add information about you to the content/authors/ folder.
  • Add your photo to the folder assets/blog/authors.
  • If your post contains images, load the pre-made images into the assets/blog/[YEAR]/[month] directory. If there is no directory, create one.
  • Add your post in Markdown to the content/blog directory. Please, specify the name of your file according to the example: "Date-name-in-style-URL" ('2022-02-12-how-to-post.md').
  • Save the changes in Git and create a commit.
  • Push changes to your repository on GitHub.
  • Open your repository on GitHub and create a pull request.

We will receive your pull request, check it and merge to our site. The post will be published after that.

By publishing your post on our blog, you will become a contributor to the repository and community. We will provide you with a special gift.

Code of Conduct

By contributing, you become a Percona Community member and agree to our Code of Conduct.

Assistance and Support

If you have any questions, please contact us:

By the way, you can even just send us the text of the post and we will publish it ourselves for you!