Re: Docs in a sorry state

2011-08-19 Thread joel the ripper
I see your point. I didn't mean anything personal to the one guy. I
look at the problems I listed as signs of health problems. If the
health problems are due in large part to Simon (?) being the only guy
with an actual hand in the project, then that would need to change in
order for the project to be healthy.

Probably it has more to do with the fact that the only guy involved
doesn't really enjoy documentation, which is understandable. But it's
not healthy, is all I'm saying. And most of the problems I listed --
broken links, etc. -- are very easy fixes.

On Jul 14, 8:35 am, ike9898 ike9...@gmail.com wrote:
 Joel - I think the problem is that (in my understanding) mGSD is the
 work of one guy, who has full-time job doing something else, and
 doesn't make money from mGSD.  I think the best we can hope for, short
 of donating enough money that he can develop this full time, is to
 organize users to contribute to the documentation, wiki-style.
 Regardless, if you've found mGSD to be a useful tool, consider
 donating a modest amount.

 On Jul 11, 11:04 am, joel the ripper dueckofe...@gmail.com wrote:







  Heavy user of mGSD here, love it. The practices and organization of
  documentation need a good deal of help though.

  I am using 3.1.7. The latest version mentioned on the blog is
  currently 3.1.6. The actual latest version is 3.1.8c, which I only
  found out by chancing to download a new blank copy. mGSD does not
  publish a changelog, so I have no way of knowing what the differences
  are between any given versions.

  The main website has almost no information about mGSD. It sends me to
  a separate resource for documentation,http://tiddlywiki.org/wiki/MonkeyGTD,
  which no longer exists, and to yet another site for the blog.

  I found out through a blog post from February 2011 that the docs have
  moved. So when I go to the new docs, and click on the Updating
  instructions, I find that they don't work (0 tiddlers to import).

  This all makes for a very unfriendly experience which limits the reach
  of your good work on the software.

  In summary:
  - Update the links on yourhttp://mgsd.tiddlyspot.com/website
  - Fix your upgrade instructions in the docs
  - Use a standard process for every release that includes posting a
  full changelog, and at the very least a blog post

  Long term, please consider actually using mGSD's main website as a
  convenient source of info about the software. Right now instead of
  providing the information one would expect, it sends you hunting
  umpteen different directions to try and glean it out of blog posts and
  newsgroup topics. Reformat at least the core, basic mGSD documentation
  into a normal, linear format and put it on the main mGSD website
  (tiddlers are a frustrating way to read documentation). Include new
  releases and a changelog on the main website. Realize that you have
  essentially a functioning, finished product here and treat it that
  way! :-)

-- 
You received this message because you are subscribed to the Google Groups GTD 
TiddlyWiki group.
To post to this group, send email to gtd-tiddlywiki@googlegroups.com.
To unsubscribe from this group, send email to 
gtd-tiddlywiki+unsubscr...@googlegroups.com.
For more options, visit this group at 
http://groups.google.com/group/gtd-tiddlywiki?hl=en.



Docs in a sorry state

2011-07-11 Thread joel the ripper
Heavy user of mGSD here, love it. The practices and organization of
documentation need a good deal of help though.

I am using 3.1.7. The latest version mentioned on the blog is
currently 3.1.6. The actual latest version is 3.1.8c, which I only
found out by chancing to download a new blank copy. mGSD does not
publish a changelog, so I have no way of knowing what the differences
are between any given versions.

The main website has almost no information about mGSD. It sends me to
a separate resource for documentation, http://tiddlywiki.org/wiki/MonkeyGTD,
which no longer exists, and to yet another site for the blog.

I found out through a blog post from February 2011 that the docs have
moved. So when I go to the new docs, and click on the Updating
instructions, I find that they don't work (0 tiddlers to import).

This all makes for a very unfriendly experience which limits the reach
of your good work on the software.

In summary:
- Update the links on your http://mgsd.tiddlyspot.com/ website
- Fix your upgrade instructions in the docs
- Use a standard process for every release that includes posting a
full changelog, and at the very least a blog post

Long term, please consider actually using mGSD's main website as a
convenient source of info about the software. Right now instead of
providing the information one would expect, it sends you hunting
umpteen different directions to try and glean it out of blog posts and
newsgroup topics. Reformat at least the core, basic mGSD documentation
into a normal, linear format and put it on the main mGSD website
(tiddlers are a frustrating way to read documentation). Include new
releases and a changelog on the main website. Realize that you have
essentially a functioning, finished product here and treat it that
way! :-)

-- 
You received this message because you are subscribed to the Google Groups GTD 
TiddlyWiki group.
To post to this group, send email to gtd-tiddlywiki@googlegroups.com.
To unsubscribe from this group, send email to 
gtd-tiddlywiki+unsubscr...@googlegroups.com.
For more options, visit this group at 
http://groups.google.com/group/gtd-tiddlywiki?hl=en.