On Thu, Dec 12, 2013 at 7:34 PM, Otis Gospodnetic <
[email protected]> wrote:

> Here's an example.  Radu found Rsyslog github repo.  It's at
> https://github.com/rgerhards/rsyslog/ .
>
> Quick comments:
> * May be better to put under https://github.com/rsyslog/ and plan on
> treating "rsyslog" as an org *assuming* one wants to add others to this org
> * I could not find this with Google.  What does that say?
> https://www.google.com/search?q=rsyslog+github+repo
> * There is no link to that from http://www.rsyslog.com/
> * The README at https://github.com/rgerhards/rsyslog is kind of
> non-existent.  Good Github projects make good use of having a nice README
> there and make use of the simple markup to make it readable.
> * The README at https://github.com/rgerhards/rsyslog points people back to
> rsyslog.com
> * The README at https://github.com/rgerhards/rsyslog points to doc dir,
> but
> ... check out index.html:
> https://github.com/rgerhards/rsyslog/blob/master/doc/index.html
>

I tried to "fix" this for github users, but it is already correct. The
readme content is:

==========================================
This file has been superseeded by the files in the doc folder. Please see
doc/manual.html for futher details. If you are looking for install
information doc/install.html is for you! If you do not have the doc set,
see http://www.rsyslog.com/doc
================================================

As is easy to see, the simple, one-click links goes to the correct place on
the rsyslog project page.

Reading you other comment, it looks like you consider any non-github
ressource a failure. This actually is against the open philosophy of
rsyslog. We don't want to tie in with any service, and while I would
definitely like to reap benefits from github, I strongly do not want to
become rsyslog depending on github. We never did this, and so we didn't
bother when e.g. sourceforge had their really bad time and so on.

I hope I have been mis-reading you in this regard.

Having said this, I am still open to change README contents. In the past,
this was not meant to be a web page replacement. This has changed now, so
it defintely makes sense to add more pointers to the real ressources to it.
I don't think - but am open to discussion - that README should replace all
those ressources.

Rainer
_______________________________________________
rsyslog mailing list
http://lists.adiscon.net/mailman/listinfo/rsyslog
http://www.rsyslog.com/professional-services/
What's up with rsyslog? Follow https://twitter.com/rgerhards
NOTE WELL: This is a PUBLIC mailing list, posts are ARCHIVED by a myriad of 
sites beyond our control. PLEASE UNSUBSCRIBE and DO NOT POST if you DON'T LIKE 
THAT.

Reply via email to