Mentat

I have just finished content reorganization on https://mentat.cesnet.cz. It now contains current information both in czech and english languages, but only information that is relevant to Mentat system as an open project. The information is kept as brief as possible with many links into the autogenerated, full and official documentation hosted on our automated build system https://alchemist.cesnet.cz.

All information related to Mentat system as a service operated by CESNET-CERTS security team for CESNET2 network users will be moved to separate webpage https://csirt.cesnet.cz/cs/services/mentat. This still needs to be done.

I have performed first revision of content on https://csirt.cesnet.cz/cs/services/mentat:

• Reorganized content in FAQ, still needs to be reread and revised
• Added description of reporting to separate webpage https://csirt.cesnet.cz/cs/services/mentat/reporting, needs another revision
• Added description of web interface to separate webpage https://csirt.cesnet.cz/cs/services/mentat/webui, needs another revision and web interface pictures
• Added link for event class list page https://csirt.cesnet.cz/cs/services/eventclass to separate FAQ section
• Added link to web user interface https://mentat-hub.cesnet.cz
• Added information about contact email

More webpage content improvements, mostly on page https://csirt.cesnet.cz/cs/services/mentat/webui. Revised the page content and added few images of web interface. I did not however went too far in describing the interface, since we will now focus on the development and many things will probably change or will be easier to reach, so the manual could get outdated very soon. I will perform one more revision of the whole content and then consider this task to be done. Some additional content improvements will be done as necessary.

I have done another revision of the web pages and now consider this issue resolved. There are still possibilities to improve the documentation, but for now all relevant information should be present. Minor tweaks can be done as necessary, improvements of documentation regarding the web interface will be better done later, when we fine tune it little bit more.

I think there is still need to add something like "Get involved" or "Contribute" page, with big fat link to https://alchemist.cesnet.cz/mentat/doc/development/html/_doclib/development.html (however rather from production branch), and with a few sentences about how to actually send patches/pull requests, how and when to get access to repo, etc. Please, think out what would suit you, as most times you will end up to be the reviewer.

• casual contributors - git send email, git am
• verified contributor - access to git
  • small fixes/changes can go to devel
  • specific features into their own branches like "feature-XXX"
  • long running features/cooperation/own playgrounds into "user-XXX" branch

However, how to guard master/release branches? only "initiated ones" should be able to merge to release and master.

Done. Your remarks made sense, so I have not changed much in your proposal. The only thing that got changed was, that I would like to do all the merging to devel, release or master branches to have better control. Even the devel branch is now quite important because of the fact, that it is connected to our build system and code gets directly released to development servers. Some minor updates on the web pages are possible, I would however like to put most of the documentation to Alchemist, to avoid duplication of information.

Please close the issue in case you approve the current state of the web pages.