add readme and contributing guides

CONTRIBUTING.md

@@ -0,0 +1,60 @@
+# Contributing
+
+If you are interested in making a contribution there are a few ways you could help out the project.
+
+## Filing issues
+
+You are free to use [GitHub issues](https://github.com/AlmaLinux/almalinux.org/issues) to submit bugs and for
+discussions related to the codebase.
+
+### Reporting a Bug
+
+Good bug reports can be very helpful. A bug is a demonstrable problem with the code or functionality.
+
+Please use the [GitHub issues](https://github.com/AlmaLinux/almalinux.org/issues) and check if the issue has
+already been reported.
+
+A good bug report should be as detailed as possible, so that others won't have to follow up for the essential details.
+
+- Submit a bug in [GitHub issues](https://github.com/AlmaLinux/almalinux.org/issues)
+
+### Requesting a Feature
+
+1. [Search the issues](https://github.com/AlmaLinux/almalinux.org/issues) for any previous requests for the same
+   feature, and give a thumbs up or +1 on existing requests.
+1. If no previous requests exist, create a new issue. Please be as clear as possible about why the feature is needed and
+   the intended use case.
+
+- Request a feature in [GitHub issues](https://github.com/AlmaLinux/almalinux.org/issues)
+
+## Contributing code
+
+If you plan to propose code changes it is required you create
+an [issue](https://github.com/AlmaLinux/almalinux.org/issues) with a brief proposal and discuss it with
+us first.
+
+This is necessary to avoid more than one contributor working on the same feature/change and to avoid someone from
+spending time on feature/change that would not be merged for any reason.
+
+For smaller contributions use this workflow:
+
+* Create an [issue](https://github.com/AlmaLinux/almalinux.org/issues) describing the changes.
+* Await confirmation from contributors.
+* Fork the project.
+* Create a branch for your feature or bug fix.
+* Add code changes, relevant documentation, etc.
+* Send a pull request.
+
+After one of the contributors has checked and approved the changes, they will be merged into master branch and will be
+included in the next deployment.
+
+## Approval of changes
+
+Before any changes can be merged:
+
+- All minor or cosmetic changes (typos, minor styling, etc) can be approved and merged by any contributor with master
+  merge rights,
+- All non-cosmetic changes to the website requires the approval of the Web Team lead and at least one other Web Team
+  member.
+- All major changes that are not purely technical, and fundamental changes in technology requires the approval of the
+  AlmaLinux OS Community Manager.

README.md

@@ -0,0 +1,45 @@
+# almalinux.org website
+
+[![almalinux.org](./screenshot.png)](https://almalinux.org)
+
+This repository contains website source code for https://almalinux.org.
+
+This website is built with the [Hugo](https://gohugo.io/) web framework.
+
+## For developers
+
+To deploy local development environment, you will need following dependencies installed
+on your development host:
+
+- hugo
+
+Executing `hugo server` will deploy a nearly complete, ready to go development environment.
+
+Localization will be incomplete unless you first run `find_missing_i18n_strings.py` and
+`setup-pages-for-supported-languages.py`.  Please do **not** commit the files which are output by these scripts.
+
+### Directories and modules
+
+- `/layouts/` - Hugo HTML templates
+- `/layouts/partial` - commonly used template such as header and footer
+- `/i18n/` - Localization files and translations
+- `/static/` - static files
+- `/content/` - Markdown content for pages
+- `config.yaml` - Hugo config
+- `find_missing_i18n_strings.py` - find strings used in layouts/templates which do not exist in the base language file
+  `i18n/en.json`
+- `setup-pages-for-supported-languages.py` - create missing markdown pages for languages which do not exist.
+  By default Hugo will return 404 for markdown content without localized pages.  This script copies the English
+  markdown to be served when translated copies are missing.
+
+### Localization and translation
+
+AlmaLinux OS localization and translation is managed using [Weblate](https://hosted.weblate.org/engage/almalinux/).
+
+To contribute translations see [AlmaLinux OS](https://hosted.weblate.org/projects/almalinux/) localization project in Weblate.
+
+You can request new languages to be added by creating a ticket in [GitHub issues](https://github.com/AlmaLinux/almalinux.org/issues).
+
+[![Translation status](https://hosted.weblate.org/widgets/almalinux/-/287x66-white.png)](https://hosted.weblate.org/engage/almalinux/)
+
+Copyright (c) 2021 AlmaLinux OS Foundation