Hi Devan, I don't quite see the point of the README.md: the existing README is perfectly readable for everybody, and having duplicate information is confusing (now one has to update two documents, and users may wonder which one they should read!). I'd prefer to focus on having one document with good quality (and README is standard in GNU), and otherwise on having a good manual (texinfo and Web site). If we want something that looks nice, effort should probably first be put into the Web site and the manual, where styling is actually effective.
As for Github, as GNU we should never endorse or encourage users to use non-free software, and Github is non-free. Hence there should not be an official mirror there either. I also don't see a need, especially since as of yesterday we do have the new GNUnet server "running" (except no services are there yet, but configuration and migration can start "today"), so we finally do have redundant infrastructure (at least once we have it all setup properly). Happy hacking! Christian On 08/01/2018 04:42 PM, Devan Carpenter wrote: > Hi everyone - > > As you can see, I've pushed a "markdown" formatted README to the repo. > Please note this is not replacing the plaintext README file. > > My goal has been to make something that newcomers can read and use to > get started with GNUnet. Hopefully containing enough in 1 single > document to where they don't have to go searching for more documentation > just to get installed and begin using GNUnet. > > Would love to hear feedback on this approach, and my attempt at it. > Also, the readme is far from complete, so please add to it. > > Now the next part of this message is about getting back on Github. I've > discussed this with a few others, and we think it could be beneficial to > have an official mirror there. I think it could even be good to think > about moving in this direction: https://wiki.gentoo.org/wiki/Gentoo_GitHub > > As long as we keep control of our own infrastructure which will remain > as the origin, I don't see any harm, and it could prove beneficial for > opening up to more developers, and interested individuals in general. > > I've created the README with rendering on Github in mind, and you can > see what it looks like here: https://github.com/dvn0/GNUnet > > Kind regards, and happy hacking > - dvn > > > > _______________________________________________ > GNUnet-developers mailing list > GNUnet-developers@gnu.org > https://lists.gnu.org/mailman/listinfo/gnunet-developers >
signature.asc
Description: OpenPGP digital signature
_______________________________________________ GNUnet-developers mailing list GNUnet-developers@gnu.org https://lists.gnu.org/mailman/listinfo/gnunet-developers
