Hi Mat and Jed
Your work is one of the most expected works. However here are my concerns

1. Organization: Having documentation alone will not do. It must be 
organized under titles and subtitles and so and so. Orgnanization will 
provide answers for the questions you have, as well as serve to showcase 
the other possibilites and alternate methods in the same tree of questions, 
from different sources and users. 

2. Scalability. If I remember correctly, I read somewhere that the 
scalability of an effort like Twederation will be difficult beyond a point. 
Shouldn't we opt for a solution that has the ability to expand?

3. Learning curve. For someone who is new to TW5, Twederation will be yet 
another thing he will have to learn, however simple it is being made into. 
This introduces the same hurdle that makes github not ideal. While we might 
not be able to make the process of creating documentation completely 
familiar, we should atleast provide a way to access the documentation on a 
familiar UI.

4. What if someone deletes his TW5? Will a copy of the documentation 
persist somewhere or will it be lost? Since twederation is not a 
client-server type setting, I guess not? If it will not persist, it means 
the whole structure of documentation becomes volatile. If it does, where 
will it stored?

5. Asking people to submit documentation is one thing, asking them to give 
access to a file that resides in their hard-drive is another. Call me 
paranoid.

6. The whole system depends on current browser security I assume. If they 
become stringent tomorrow, what will happen?

7. Yours is a voluntary effort. I am not in anyway questioning you guys' 
commitment to the project of Twederation, but what if at a point tomorrow 
life makes it hardly possible to maintain the project of Twederation?

I understand that people will not submit documentation eagerly. Hence the 
suggestion to make it a community agreement that if users get a 
satisfactory solution for their problem from the group, they will simply 
write it up and file it under the appropriate heading.

A lot of questions have very simple answers. It is quite sad that such an 
effort requires this much push.

I want to remind the group in general in no uncertain terms - there is a 
dearth of documentation. Unless we do that, in a world full of easy 
solutions, people will not get a chance to know TW. One of you veterans, if 
they take any kind of steps to set up such a community documentation, they 
will have my whole hearted support and I offer any kind of help I can 
provide.

Yours sincerely
Someone who realised yesterday that changes made to tiddlers starting with 
$:/state will not make TW dirty.

-- 
You received this message because you are subscribed to the Google Groups 
"TiddlyWiki" group.
To unsubscribe from this group and stop receiving emails from it, send an email 
to tiddlywiki+unsubscr...@googlegroups.com.
To post to this group, send email to tiddlywiki@googlegroups.com.
Visit this group at https://groups.google.com/group/tiddlywiki.
To view this discussion on the web visit 
https://groups.google.com/d/msgid/tiddlywiki/02e90aa1-99c8-4f85-971a-bb2b90e792ca%40googlegroups.com.
For more options, visit https://groups.google.com/d/optout.

Reply via email to