Could make a special cases section?<br><br>Anyway, that stuff is nearly written, let's get examples of pointing, pointing! :) The key part! The essential part! The part I don't know much about because I just asked my host and they did it for me! :)
<br><br>Anisa.<br><br><div><span class="gmail_quote">On 10/6/06, <b class="gmail_sendername">Laura Scott</b> <<a href="mailto:laura@pingv.com">laura@pingv.com</a>> wrote:</span><blockquote class="gmail_quote" style="border-left: 1px solid rgb(204, 204, 204); margin: 0pt 0pt 0pt 0.8ex; padding-left: 1ex;">
On Oct 5, 2006, at 1:55 PM, Boris Mann wrote:<br><br>> Please...the term "multi-site" refers ONLY to Case 1 -- nothing<br>> shared, just running on the same codebase.<br>><br>> If this is a HOW TO for *sharing content*....that is a whole other
<br>> tutorial, and is not officially supported (although pulling together<br>> the info would be great). As I hinted at earlier, you can do sharing<br>> content without multi-site...it's ALL done at the database layer.
<br>><br>> So...I think it should in fact be titled "HOW TO: Sharing<br>> content/users between Drupal sites"...making no mention of multi-site.<br><br>-1 to this idea.<br><br>Multisite has been used to mean at least 3 different approaches --
<br>different databases, same database, hybrid. That is what people will<br>be looking for. To deliberately avoid using the word out of a desire<br>for diction purity would, in the end, make the handbooks a little<br>less usable by making the content a little less findable.
<br><br>I could see how it could be part of a larger section on sharing<br>content, where then feednode approaches, publish/subscribe, and other<br>ideas would also be addressed. It should all be in the same area,<br>imho. But having multisite covered in one area, and sharing content
<br>somewhere else altogether, would make no sense to me -- nor, I<br>imagine, most d.o users.<br><br>I think the best documentation will address user needs as being task-<br>oriented, as opposed to organized by functionality or terminology
<br>exclusively.<br><br>Consider an auto manual. How do you check your clutch fluid? A strict<br>function-oriented manual would have an explanation of under-dash<br>controls in one area. Now you can pop the hood. Another area will
<br>have an explanation of where all the dipsticks and reservoirs are.<br>Now you can spot the clutch fluid reservior. Another area of the<br>manual will explain the engine fluids. Now you can understand the<br>importance of clutch fluid. Yet another area will tell you how to
<br>remove the cap. Perhaps another area will offer "best practices" on<br>how to do things like check fluids. Some other area yet explains that<br>you don't want to check such fluids when the engine is hot. Yet
<br>another area will tell you just what level the clutch fluid should<br>be. Maybe another area will describe the kinds of tools you should<br>have on hand.<br><br>OR<br><br>The manual has an area on owner maintenance. One section covers it
<br>all. Ah, there's the part on clutch fluid. Right there are all the<br>essential pieces of info, from all these different /functions/ of the<br>car, pulled together in a way so the person can do the task. (Can you<br>tell I had to deal with precisely this on my car recently?)
<br><br>Back to Drupal handbooks.... People will be looking for ways to solve<br>a problem, most likely. For example, "I have seven sites that are<br>related somehow. How am I going to configure this?" They /might/
<br>search for "sharing content" but odds are they've heard or read about<br>multisite, and could very likely use that term, too. However they<br>search, my feeling is that the results should lead them to an area
<br>with all of it. To have people search for multisite get only one of a<br>half dozen or more approaches, with maybe a mention to refer to some<br>totally different area of the handbooks, would be like the first auto<br>
manual above -- accurate, perhaps, but not very handy for a handbook.<br>Like it or not, "multisite" is an important keyword for a large part<br>of content-sharing tasks.<br><br>If I'm preaching to the choir, please consider this a friendly rant
<br>to the spheres of the universe.<br><br>Laura<br>--<br>Pending work: <a href="http://drupal.org/project/issues/documentation/">http://drupal.org/project/issues/documentation/</a><br>List archives: <a href="http://lists.drupal.org/pipermail/documentation/">
http://lists.drupal.org/pipermail/documentation/</a><br></blockquote></div><br><br clear="all"><br>-- <br>*********************************<br><a href="http://www.AnimeCards.Org">www.AnimeCards.Org</a><br><br>16,000 scans and counting!
<br>*********************************