Re: [Semediawiki-user] [SF] Documentation overhauled

[Yaron K. <ya...@wi...>]

Hi Sal,

Yes, being able to do a full text search is indeed a big advantage of having
everything on one page - that was another reason why I wanted to keep things
as they were for a long time. I tried to make the section descriptions on
the front page comprehensive, so that if you did a text search for, say,
"formlink", you would find the relevant section - and I also tried to put in
a bunch of "see also" type links within the different sections. Still, it's
not quite the same.

Yes, it's possible to do a MediaWiki search on all pages within
"Extension:Semantic Forms/...". You can see the "Search archives" input in
the talk page for an example of that sort of thing:

http://www.mediawiki.org/wiki/Extension_talk:Semantic_Forms

Still, it's not nearly as convenient as a simple browser text search. If
there are specific strings you remember searching for, that now would be
harder to find, I'm curious to hear what they were.

-Yaron

On Tue, Sep 6, 2011 at 9:01 PM, Sal Quintanilla <sal...@gm...> wrote:

> I'll always encourage making documentation as manageable and readable as
> possible.  But in this case, I see a problem regarding page search.  When I
> used the old page, I'd search for phrases that often led me to 2 or more
> sections to get the full concept.   Now groups of sections are on separate
> pages, and to search for certain phrases thoroughly I might have to open 1
> or more pages... and paranoia might lead me to open pages that don't seem
> to
> be related, "just in case".
>
> If the page set were its own site, or if search could be limited to the
> Extension:Semantic Forms/* articles, this wouldn't be a problem (and if
> that's already syntactically possible, please share, I could use that
> feature on my own site).  As it is now, it might take some work to find all
> things related to the string I'm searching for, compared to just clicking
> "next".
>
> Regards,
> Sal
>
>
> -----Original Message-----
> From: Yaron Koren [mailto:ya...@wi...]
> Sent: Tuesday, September 06, 2011 5:39 PM
> To: Semantic MediaWiki users
> Subject: [Semediawiki-user] [SF] Documentation overhauled
>
> Hi everyone,
>
> I restructured the Semantic Forms documentation, separating it into
> subpages. The main page now holds just links to the subpages, as well as a
> quick "cheat sheet" at the bottom:
>
> http://www.mediawiki.org/wiki/Extension:Semantic_Forms
>
> I resisted doing this for a long time, because I had gotten used to having
> everything on one page. But as the amount of information grew, the
> documentation became unwieldy to read - and, as I realized, possibly too
> unwieldy to edit either. The new setup hopefully makes it easier for people
> to do both.
>
> Any comments about the new structure of the documentation are welcome -
> maybe the "Defining forms" subpage, which is by far the longest, should get
> split up; or, conversely, maybe some of the very short subpages should get
> merged together, etc.
>
> -Yaron
>
> ----------------------------------------------------------------------------
> --
> Using storage to extend the benefits of virtualization and iSCSI
> Virtualization increases hardware utilization and delivers a new level of
> agility. Learn what those decisions are and how to modernize your storage
> and backup environments for virtualization.
> http://www.accelacomm.com/jaw/sfnl/114/51434361/
> _______________________________________________
> Semediawiki-user mailing list
> Sem...@li...
> https://lists.sourceforge.net/lists/listinfo/semediawiki-user
>
>


-- 
WikiWorks · MediaWiki Consulting · http://wikiworks.com