← Back to team overview

zim-wiki team mailing list archive

Re: Document folder and document root - difference

 

2009/1/26 Jaap Karssenberg <jaap.karssenberg@xxxxxxxxx>:
> Dotan Cohen wrote:
>>
>> If xyz was called A and lmn was called B, then do not start calling
>> anything else A or B. That will only lead to confusion when people say
>> "I am using A" and you have to ask "the original A or the new A".
>> Worse yet, you might not ask and _assume_ the wrong one. I suggest
>> these new names:
>>
>
> I agree with you in theory. But until we hit 1.0 I will break this rule
> occasionally if it makes the concepts of the applications as a whole more
> obvious. When the python release comes out this will be the logical point
> for some of those breaks.
>

That is a good point, not having a release means not tied to any strings.

> But not yet decided.
>
>> "document folder" -> "attachment folder"
>> "document root" -> "~/.zim" and don't ask the user. No other
>> application asks the user to select where application-specific files
>> will be saved. As these file are intended to be used in Zim only (what
>> other application can read the wiki-style code anyway), there is no
>> need for it to be anywhere other than a hidden .zim directory.
>>
>
> The document root is _not_ the notebook root. The document root is where
> other files can be found that are specifically not application specific.
> E.g. Ubuntu has a default directory called ~/Documents, this is the logical
> default for the document root.
>
> For the notebooks itself one could argue to put them in an application
> specific directory. But I will never use a hidden folder for that. There are
> 2 reasons I will never do that:
>
> 1) A lot of users do not even know there are hidden directories and will not
> be able to find the text files.

Why would they _want_ to find them?

> 2) The risk of backup schemes that do not backup hidden directories is to
> big
>

That would be a point if email clients, PIM applications, and other
programs that store user data also used the same argument. But keeping
a directory hidden just to be sure that the user will back it up if he
wants sounds like overkill (it does more harm than good). Why even
have hidden directories?

> I want users to know there pages are safe and readable without zim.
> Therefore I consider it a design rule to never put user data in hidden
> directories.
>

Those two ideas are not mutually exclusive, Jaap.

-- 
Dotan Cohen

http://what-is-what.com
http://gibberish.co.il

א-ב-ג-ד-ה-ו-ז-ח-ט-י-ך-כ-ל-ם-מ-ן-נ-ס-ע-ף-פ-ץ-צ-ק-ר-ש-ת
ا-ب-ت-ث-ج-ح-خ-د-ذ-ر-ز-س-ش-ص-ض-ط-ظ-ع-غ-ف-ق-ك-ل-م-ن-ه‍-و-ي
А-Б-В-Г-Д-Е-Ё-Ж-З-И-Й-К-Л-М-Н-О-П-Р-С-Т-У-Ф-Х-Ц-Ч-Ш-Щ-Ъ-Ы-Ь-Э-Ю-Я
а-б-в-г-д-е-ё-ж-з-и-й-к-л-м-н-о-п-р-с-т-у-ф-х-ц-ч-ш-щ-ъ-ы-ь-э-ю-я
ä-ö-ü-ß-Ä-Ö-Ü



References