Phil,

How about if you try “exposing” the existing “user documentation” on Github?  See my earlier email for what I mean by “user documentation”.  The documentation is in .pod and .html files in the /docs directory.  These are the pages that show up on sourceforge now.  Lieven indicates that it is possible to have the wiki pages in a Github repository; I wonder if that means in the “same” repository as the code files?  If so then maybe you can search Github for instructions?  If you are willing, I think this approach might work:

 

1)     Create your own Github account, if you don’t already have one

2)     Clone the MH repository

3)     Explore, learn, and experiment with the wiki and the documentation on your repository until you figure out how to expose the /docs directory on your the wiki

4)     Let those of us on the list take a look

 

If the list likes what you have created we can then:

5)     Pull your changes and repository configuration into hollie/misterhouse

6)     Ask to have misternouse.net redirected to the Github landing page you created

 

Bing….   Done and developers can easily update the user docs now.

 

Sincerely,

Michael

 

 

From: Phil McDonnell [mailto:phil@philmcdonnell.com]
Sent: Sunday, February 24, 2013 12:18 PM
To: misterhouse-users@lists.sourceforge.net
Subject: Re: [mh] Permissions to update sourceforge HTML pages

 

And to be clear: proposing the git wiki was just a suggestion. I'll follow whatever solution is selected. I just find myself editing the git wiki more easily compared to the wikispaces pages.

 

After following all the threads about this documentation and the project in general it seems that everyone wants to have one place for everything but nobody is taking on the task of doing it.

 

I am a newbie to Git but have caught on pretty well... Seems to me that Git is the correct choice to use as it makes it easy for everyone to submit updates and additions. Of course this is just my opinion but the project really needs one place to go and not have links all over the place leading a new user in different directions which in many cases is wrong!

 

Would it be possible to get misterhouse.net to forward to Git? Is there anyone who is willing to be the project leader? I for one would be glad to help with consolidating all docs, etc to one location so that we as a group can have a place where anyone can find the project and all the details which would be accurate and up to date.

 

Also it seems that most of the development/docs are geared toward Linux which is fine but a Windows centric page and how to would be really good to have as well as a latest compiled version for Windows. 

 

So that all being said I would be willing to move all the current docs to Git and then we can slowly update them there. Of course since I am new to MH I don't really know what is outdated or not so I would need help in editing.

 

Lastly there seems like much back and forth about where the project should live but nobody is actually doing something about it. Should a vote be setup to see where it lives? I personally don't think leaving docs in one place, downloads in another would be any good. A nice landing page on the misterhouse.net domain that points to either Git or SVN would be the desired way to go in my opinion.

 

Sorry if I am being to brash for a newcomer but I see the potential in MH and hate to see it just flounder like it is currently...

 

Regards,

Phil