Make documentation less confusing

Tech support and suggestions forum. If you only have a basic question on how to get started, please use the "newbies" forum in the community section.

Moderator: joepal

Make documentation less confusing

Postby wolgade » Fri May 10, 2019 10:20 am

Well, so I decided to switch to Python3. I wanted to use the source code. This was harder than I thought due to outdated, misleading, missing or hard-to-find documentation.

The most obvious road to follow is a very recent post by Joel (http://www.makehumancommunity.org/forum/viewtopic.php?f=9&t=12448), but this will give you the deprecated source code (Bitbucket) without telling you. EDIT: I finally realized that this posting is rather old, so Joel is not to blame. Anyway a good reason to update this thread.

My next attempt was to look at http://www.makehumancommunity.org/wiki/Releases. The pages dealing with 1.2.0 contained a subsection called "running from source" without telling you where to get the source. I edited these pages. Now they do.

I finally found what I was looking for at http://www.makehumancommunity.org/content/downloads.html, but at the wrong place. The link to Github is in the section "stable version", which is simply wrong. You still find the stable version on Bitbucket. Github will give you Python3.
wolgade
 
Posts: 795
Joined: Wed Jan 30, 2013 6:50 pm


Re: Make documentation less confusing

Postby joepal » Fri May 10, 2019 11:02 am

Help updating the wiki is very, very welcome.

Did you manage to solve it in the end?
Joel Palmius (LinkedIn)
MakeHuman Infrastructure Manager
http://www.palmius.com/joel
joepal
 
Posts: 4465
Joined: Wed Jun 04, 2008 11:20 am

Re: Make documentation less confusing

Postby wolgade » Fri May 10, 2019 11:05 am

joepal wrote:Did you manage to solve it in the end?

Sure! :D But I took notes on any problem I had with the intention to clarify documentation.
wolgade
 
Posts: 795
Joined: Wed Jan 30, 2013 6:50 pm

Re: Make documentation less confusing

Postby RobBaer » Fri May 10, 2019 12:50 pm

Thanks for all your help and contributions. The community is stronger for members like you.
User avatar
RobBaer
 
Posts: 1208
Joined: Sat Jul 13, 2013 3:30 pm
Location: Kirksville, MO USA

Re: Make documentation less confusing

Postby punkduck » Sat May 11, 2019 7:22 pm

wolgade wrote:Sure! :D But I took notes on any problem I had with the intention to clarify documentation.


Great Wolgade ;) Coders like me have two main problems:

  • we are often too lazy to write a good documentation. And I am not only speaking about the forum. Ask the guys where I work :mrgreen:
  • some things simply work ... we don't know why or we forgot ... please don't ask us. In program code we mark these spots with our signs ... a typical one is: #TODO and sometimes, more realistic #WTF :lol:

So yes, we appreciate this help. Since we both are in contact for more than a year, you know that about me ;)
User avatar
punkduck
 
Posts: 1216
Joined: Mon Oct 17, 2016 7:24 pm
Location: Nuremberg, Germany

Re: Make documentation less confusing

Postby loki1950 » Sat May 11, 2019 11:28 pm

It's not so much laziness as the team leader handing you your next six assignments to add to your already full to do list :shock:

Enjoy the Choice :)
my box::HP Envy i5-6400 @2Q70GHzx4 8 Gb ram/1 Tb(Win10 64)/3 Tb Mint 19.2/GTX745 4Gb acer S243HL K222HQL
Q8200/Asus P5QDLX/8 Gb ram/WD 2Tb 2-500 G HD/GF GT640 2Gb Mint 17.3 64 bit Win 10 32 bit acer and Lenovo Ideapad 320-15ABR Win 10/Mint 19
User avatar
loki1950
 
Posts: 1219
Joined: Thu Dec 18, 2014 6:27 pm
Location: Ottawa,Ontario


Return to Bugs, problems and feature requests

Who is online

Users browsing this forum: No registered users and 1 guest

cron