Re: [GNUnet-developers] New README.md and Github

[Christian Grothoff]

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
> address@hidden
> https://lists.gnu.org/mailman/listinfo/gnunet-developers
>

signature.asc
Description: OpenPGP digital signature