librebootable.info
- Anmelden oder Registrieren um Kommentare zu schreiben
Thanks to comments from the forum and the willingness of Vikings.net to host a site dedicated to information about devices flash-able with libreboot, librebootable.info is slowly on its way to become a reality. In my sparse free time I am studying how to set up a wiki using MediaWiki (is this a good choice?). I have absolutely no prior experience or knowledge so it is a slow process and it is difficult for me to determine when I am ready to tell Vikings.net that I am ready. Then, they will set up a VPS (Virtual Private Server) with an operating system and give me ssh access. From there, I am on my own - unless someone here can help me.
I have a few initial questions:
1) Should writing access require registration?
2) How to ensure the quality of content?
3) Can the wiki be active for editing to select contributors until there is enough content to open access to 'the public'? And is this even a good idea?
4) Can I make work sheet or note page to make an overview of tasks and ideas to be considered and dealt with?
Any help is most appreciated.
Landing page: Purpose and raison d'être
* libreboot (general)
- installation types (SW/HW)
* Devices: Types and categories (i.e. cpu and gpu)
- information about e.g. commands to retrieve data about display, ram, cpu etc
- specific model
- description
- variants and possible issues about parts
- installation method(s)
- installation manual(s)
- upgrade, enhancement, tips & tricks, tweaks, settings
- compatible parts and spares
* Discussion of'best' options: general
- SW method devices
- HW method devices
* Suppliers of librebooted computers and installation service
* Known retailers/sources of usable computers and parts
- per retailer/source
- per type of part
* A buyers guide
- comparison of (inherent) device characteristics
- tips for where to find items
- recommended market price
* Libre OS: What makes an OS libre
- specific OSes (inclusing a page or a section about Replicant)
* GNU/fsf: General
- How to move on to free your computer and yourself (use of computer)
- how to keep your liberated computer liberated
- suggested software
- suggested use (including browser)
+ A Vikings.net banner (thanks for hosting)
Should it not be possible to install MediaWiki on my computer and pretend it's on a server? In this way I would be able to practice on my own computer.
It is. You simply install your server locally with something like :
sudo apt-get install apache php mysql php-mysql (approximate, check the packages name)
then you just have to put the mediawiki files in /var/www and install it with your browser by typing "localhost" in the adress bar.
hi GNUbahn,
We have some pretty extensive documentation on the libreboot website and the documentation is in Markdown now so it should be much easier to edit and contribute to it. The documentation is in the Git repository. Instructions for sending documentation patches:
https://libreboot.org/git.html
We've establish quite a solid code review infrastructure using notabug.org pull requests, and we usually merge patches pretty quickly.
Why not contribute to the official Libreboot documentation instead of creating a separate site? We currently have a major skills shortage in the project, and lack of people who can write good documentation is one of the problem areas.
~Leah
Indeed - it seems better to work on the canonical libreboot site rather than fragmenting effort by starting a new one.
We used to have static HTML documentation and it was hard to send patches. Both problems are solved.
It is now very easy to contribute to the official Libreboot documentation, using the instructions on https://libreboot.org/git.html
The documentation is in Markdown, which is very easy to use and much simpler than the markup language used in MediaWiki for instance. Notabug's interface for sending patches via pull requests is pretty efficient too and we merge patches quickly most of the time.
I feel like a separate site will fragment the community. It also means that documentation will inevitably go out of date on the forked site as we update and improve Libreboot, and it means that we in Libreboot get less documentation contributions.
Personally, I think it's better to keep everything under libreboot.org. We've had problems with third party documentation sites before, for the exact reasons mentioned above.
You also do not need a local webserver to view your changes to the Libreboot docs. You can just open the pages you're editing in a web browser and browse through your local copy of the site.
The entire libreboot.org website is a Git repository hosted on https://notabug.org/libreboot/ :)
I've opened a new thread:
https://trisquel.info/en/forum/libreboot-website-now-wiki-and-we-are-looking-documentation-contributors
This should hopefully make it clearer to people now how to contribute to the real Libreboot site, in terms of documentation and website improvements, so as to help more people with better documentation.
GNUbahn, what do you think of this?
Hi GNUbahn,
To make it easier for people, we have now added the following to the Libreboot site:
* "Edit this page" link is now added on every page automatically, to every page on the website and documentation pages
* More useful instructions for how to contribute to the Libreboot documentation and site
The entire libreboot.org is a wiki now. We have a team of moderators who review contributions for quality assurance purposes, and we're looking for more people to join our team (see https://libreboot.org/management.html)
See this page for info on sending improvements to libreboot docs:
https://libreboot.org/git.html#editing-the-website-and-documentation-wiki-style
Patches welcome :)
~Leah
Hi Leah.
Just a short comment on the edge of bedtime: I agree that one place for all is better. But I also think, that though libreboot.org seems to attempt to reach out to non-techies, it is missing some. This has to do with formulations as well as structure. I would suggest to modify the structure a little (nor the lay out - I like the simplicity) and focus on writing for non-techies - I am sure that savvy people can read that too. The extensive documentation needs to be sorted, so that one reads/meets it as knowledge grows (some sort of progression) and in appropriate chunks.
My spare time is limited but when I find some time, I will make a (rough) proposal for a page or two - that gives us concrete examples to starts discussions from. Thanks for reaching out and poking me.
Hi GNUbahn,
Yes, non-techies are Libreboot's major target in the documentation. We also want to have complete documentation, though.
Streamlining everything and simplifying is a current goal.
I ask that you contribute directly to the official Libreboot documentation to make these improvements, instead of forking off into librebootable.info, as I feel that Libreboot would be better served with its own documentation improved.
Indeed, I welcome such discussions. You can start it on the bug tracker linked on the homepage, and we can go from there with a few examples in the form of pull requests. libreboot.org is where most people look so it's better to improve that.
The current infrastructure has improved considerably and should be easy enough to contribute to nowadays, compared to what it was like before.
~Leah
Also, to support Libreboot having all documentation in one place (the
main web site), see
[[https://www.wingolog.org/archives/2015/11/09/embracing-conways-law]].
--
- [[https://libreplanet.org/wiki/User:Adfeno]]
- Palestrante e consultor sobre /software/ livre (não confundir com
gratis).
- "WhatsApp"? Ele não é livre, por isso não uso. Iguais a ele prefiro
GNU Ring, ou Tox. Quer outras formas de contato? Adicione o vCard
que está no endereço acima aos teus contatos.
- Pretende me enviar arquivos .doc, .ppt, .cdr, ou .mp3? OK, eu
aceito, mas não repasso. Entrego apenas em formatos favoráveis ao
/software/ livre. Favor entrar em contato em caso de dúvida.
This is good news, i'll inform my friends who play with coreboot.
- Anmelden oder Registrieren um Kommentare zu schreiben