AntiMicroX / AntiMicroX/antimicrox.github.io

Create basic site

オープン
#1 コメント 23 件 リアクション 0 件 担当者 0 名 GitHub で見る
documentation good first issue
主要言語
JavaScript
スター
2
フォーク
4
PR マージ指標
30日以内にマージされた PR はありません

説明

I think it would be good to discuss, how this site should be done both in terms of technical and in terms of content.

### Technical side:
I think it would be the best solution to make this site using some kind of generator.

In my opinion the best would be combination of [MkDocs](https://www.mkdocs.org/) with [material-theme](https://squidfunk.github.io/mkdocs-material/) it would be deployed using GitHub actions after every push to master branch.

I think MkDocs would be suitable for us because:
- It is easy to write articles here, they can be written using regular Markdown (with additional pieces written in HTML if more flexibility would be needed)
- It has a lot of themes
- can be easily integrated with github pages
(but this seems to be done mainly for documentation, not regular sites, I am not sure)

### Content
I think this side should contain:
- as a main site it would be good to have short, visual description, what antimicrox is, how it looks etc
- some usage instructions (based on old wikis)
- Simple download and install page
- other things from legacy wiki: https://github.com/AntiMicro/antimicro/wiki https://github.com/juliagoda/antimicrox/wiki

I am open for any comments and opinions about solutions proposed above.

コントリビューションガイド

このリポジトリのコントリビューションガイドは索引されていません

評価

この issue はまだ評価されていません。

新しい issue をメールで受け取る

初心者向けの GitHub issue を短くまとめたダイジェスト。