doc.wikidot.com

nav_first.pngFirst: thread:102
Marketplace
Edited: 1255961848|%e %b %Y by: pieterh
Comments: 5
Tags:

nav_prev.pngPrevious: thread:51
includes.wikidot.com
Edited: 1255961848|%e %b %Y by: pieterh
Comments: 1
Tags:

nav_last.pngLast: thread:44
chatroom.wikidot.com
Edited: 1255961848|%e %b %Y by: pieterh
Comments: 10
Tags:

nav_next.pngNext: thread:40
event-calendar.wikidot.com
Edited: 1255961848|%e %b %Y by: pieterh
Comments: 25
Tags:

pieterhpieterh wrote on 1252658699|%e %b, %H:%M (%O ago)

This is a thread for discussing the http://doc.wikidot.com site.


Start a new sub-thread

Comments: 17

Removed experimental/etc.
pieterhpieterh 1252658766|%e %b %Y, %H:%M %Z|agohover

Hey Kenneth, I removed the experimental/concept/ stuff from the module:_admin page. It's better that the documentation is all always stable, and that conceptual stuff happens elsewhere.

unfold Removed experimental/etc. by pieterhpieterh, 1252658766|%e %b %Y, %H:%M %Z|agohover
Re: Removed experimental/etc.
tsangktsangk 1252756595|%e %b %Y, %H:%M %Z|agohover

Thanks, that looks a lot neater. :-)


First Wikidot Wiki with a Chinese Domain! -> http://曾勁驊.info.tm/ or http://kenneth.wikidot.com

Out of your site limit? I've got 996 sites left. Ask me and I'll create one for you! Just PM me and let me know.^

^If you require an Iron Giant Template cloned site, please tell me that too!

unfold Re: Removed experimental/etc. by tsangktsangk, 1252756595|%e %b %Y, %H:%M %Z|agohover
Saturday's rant fever
gerdamigerdami 1252750628|%e %b %Y, %H:%M %Z|agohover

This doc gonna a be an English only website as I see how it is designed

unfold Saturday's rant fever by gerdamigerdami, 1252750628|%e %b %Y, %H:%M %Z|agohover
Re: Saturday's rant fever
pieterhpieterh 1252849590|%e %b %Y, %H:%M %Z|agohover

This doc gonna a be an English only website as I see how it is designed

I'm not sure, but what's clear is that whatever I write (representing the official voice of Wikidot) in terms of doc will be English, period. So how, when, where do we translate?

unfold Re: Saturday's rant fever by pieterhpieterh, 1252849590|%e %b %Y, %H:%M %Z|agohover
Re: Saturday's rant fever
gerdamigerdami 1252876680|%e %b %Y, %H:%M %Z|agohover

The lonely proposal for a multilingual documentation was made on the simple basis: category is used for language. There might be another solution, launch a call for better solutions.
In the meantime, I say: http://doc.wikidot.com is not designed as a multilingual documentation, period.

unfold Re: Saturday's rant fever by gerdamigerdami, 1252876680|%e %b %Y, %H:%M %Z|agohover
Re: Saturday's rant fever
pieterhpieterh 1253023749|%e %b %Y, %H:%M %Z|agohover

@Gerdami: my first vision for the doc site was to make an evolution of the current doc category. There is always the danger of "version 2 syndrome" when we try to do too much at once, so I prefer to make changes in small discrete steps.

Mainly a new site is to allow improvements to the current English doc. For example, Kenneth's idea of a wish per documentation page, which I think is great - it captures a certain kind of discussion in a clean way.

A multilingual project needs IMO to work off a fairly stable basis. So I'd see this happening when the doc site has gone through a first complete build.

The Wikipedia solution is to build independent sites (for us, Clone + Translate).

The Google solution is live translation (sidebar widget).

What's the Wikidot solution? We don't have large non-English communities but this could be way to encourage that.

How feasible would it be to add babel capability to the doc site after it's been built?

unfold Re: Saturday's rant fever by pieterhpieterh, 1253023749|%e %b %Y, %H:%M %Z|agohover
Re: Saturday's rant fever
gerdamigerdami 1253033098|%e %b %Y, %H:%M %Z|agohover

so I prefer to make changes in small discrete steps

Hence, do not create a new site. Keep enhancing the present one.

  • Simply cut the current syntax page in pieces - as it is the case for the modules -
  • Modify the _template as we discussed before by adding a link to the community/help-on:%%name%% example community.wikidot.com/help-on:listpages-module

The Wikipedia solution is to build independent sites

Do not compare with Wikipedia and its thousands of editors

The Google solution is live translation

It's not a solution, it's just a gadget which users find annoying at use. Those who rely on Google translate have it in their browser's toolbar.

How feasible would it be to add babel capability to the doc site after it's been built?

  • No chance at all. Because the babel model uses the categories for language. I continue to think that its was a genius idea because very simple.
  • I admit that eating categories for language undermined the feasibility of the whole system. However it was at a time when the parent selector did not exist.
  • Now, let's take the modules. en:modules is the parent, add create button with parent=en:modules, you can ListPage all modules whose parent is en:modules.
  • Now, let's take the syntax you have previously and conscientiously sliced in sub-pages. en:syntax is the parent. en:syntax-1-inline-formatting, en:syntax-2-text-size, … are the children. (Yes, begin with the changes to the current doc)
  • Embedding ? en:embed is the parent; en:embed-1; en:embed-2 … etc one page per embedding service (Yes, begin with the changes to the current doc)
  • Add some tags at wish

ListPages parent="en:embed" tags="video,audio"

End of post for the moment

unfold Re: Saturday's rant fever by gerdamigerdami, 1253033098|%e %b %Y, %H:%M %Z|agohover
Re: Saturday's rant fever
gerdamigerdami 1253034104|%e %b %Y, %H:%M %Z|agohover

Forget the autonumbering with the babel model !


1st mockup : http://babel-doc.wikidot.com/en:modules

last edited on 1253036796|%e %b %Y, %H:%M %Z|agohover by gerdami + show more
unfold Re: Saturday's rant fever by gerdamigerdami, 1253034104|%e %b %Y, %H:%M %Z|agohover
Please restore the "Short description of changes" box in this doc.wikidot.com site
gerdamigerdami 1252753864|%e %b %Y, %H:%M %Z|agohover

It is really annoying of being unable to add comments to edits.
For those who disagree: please consider that:

  • it is way to communicate with others the changes we make to a page
  • it is an easy way to comment the step-by-step edits
  • it really helps to revert to a previous version when something went wrong
Re: Please restore the "Short description of changes" box in this doc.wikidot.com site
leigerleiger 1252762530|%e %b %Y, %H:%M %Z|agohover

I agree 100%. Was going to post that but didn't get around to doing it yet.

Re: Please restore the "Short description of changes" box in this doc.wikidot.com site
pieterhpieterh 1252849425|%e %b %Y, %H:%M %Z|agohover

Ooops. I put the latest editor CSS on the various expert sites but forgot this one. It's really quite painful to not have cross site includes.

pieterhpieterh 1252851284|%e %b %Y, %H:%M %Z|agohover

@Kenneth,

Just to say that I really appreciate the work you're doing on the doc site, and I like the ideas, like adding a wish section. Next week I'll find some time to actually start writing content, and we can see how this integrates. I need to redesign the large documentation pages into pieces that can be linked together properly. E.g. we have a 'category selector' in many modules, it should be documented exactly once.

The wishes should be attached to doc pages (parenting) and have some state (_closed means done or canceled). Maybe you already did that.

Uhm, Gerdami, thanks to you to, I see your edits.

last edited on 1252851335|%e %b %Y, %H:%M %Z|agohover by pieterh + show more
unfold by pieterhpieterh, 1252851284|%e %b %Y, %H:%M %Z|agohover
Re:
tsangktsangk 1253003199|%e %b %Y, %H:%M %Z|agohover

Ok. Adding the _closed tags now. Just a question, do i apply the wishes for the category "doc"?


First Wikidot Wiki with a Chinese Domain! -> http://曾勁驊.info.tm/ or http://kenneth.wikidot.com

Out of your site limit? I've got 996 sites left. Ask me and I'll create one for you! Just PM me and let me know.^

^If you require an Iron Giant Template cloned site, please tell me that too!

unfold Re: by tsangktsangk, 1253003199|%e %b %Y, %H:%M %Z|agohover
Re:
pieterhpieterh 1253023919|%e %b %Y, %H:%M %Z|agohover

do i apply the wishes for the category "doc"?

Yes, I think so. Since the parent page can be anywhere, there is no conflict. You are autonumbering wishes, right?

You should take a look at the babel-template.wikidot.com site and see how Gerdami has implemented multilanguage wikis. We need to not build structures that are untranslatable afterwards.

There may be, as Gerdami says, other ways to do multilingual sites. It is something we need to add into Wikidot at some stage anyhow.

unfold Re: by pieterhpieterh, 1253023919|%e %b %Y, %H:%M %Z|agohover
pieterhpieterh 1253268481|%e %b %Y, %H:%M %Z|agohover

@Kenneth, I've pasted the new ListPages doc into the site.

The use of sections makes it kind of difficult. I think we need to reduce this to one section. Examples and wishes can be separate. The first paragraph can always be the summary.

unfold by pieterhpieterh, 1253268481|%e %b %Y, %H:%M %Z|agohover
Re:
tsangktsangk 1253271719|%e %b %Y, %H:%M %Z|agohover

Done. :-)


First Wikidot Wiki with a Chinese Domain! -> http://曾勁驊.info.tm/ or http://kenneth.wikidot.com

Out of your site limit? I've got 996 sites left. Ask me and I'll create one for you! Just PM me and let me know.^

^If you require an Iron Giant Template cloned site, please tell me that too!

unfold Re: by tsangktsangk, 1253271719|%e %b %Y, %H:%M %Z|agohover
Re:
pieterhpieterh 1253626809|%e %b %Y, %H:%M %Z|agohover

:-) Nice.

unfold Re: by pieterhpieterh, 1253626809|%e %b %Y, %H:%M %Z|agohover
Add a new comment
page_revision: 2, last_edited: 1255961848|%e %b %Y, %H:%M %Z (%O ago)
Unless otherwise stated, the content of this page is licensed under Creative Commons Attribution-ShareAlike 3.0 License