Thread: Re: [limesurvey-developers] Initial doc mini-project proposal
The leading Open Source survey tool
Brought to you by:
c_schmitz
From: Carsten S. <car...@go...> - 2009-01-19 11:07:42
|
Hello Randy, your proposals sounds good to me. Please get at it if you have the time. I also made you an editor in the wiki so you can move things around. I don't think staging is necessary. Please not also that I am just testing a Wiki just for internationalization of documentation (Anwiki), because I think that the current TikiWiki features for keeping translations synchronized are not very good. I will keep you all posted on the progress. Best regards Carsten Schmitz Randy Harr, Sevni schrieb: > Just checked out your updates to the Manual Guidelines page. > > Cookbook, Limes. Around here that usually means Tequila and > Margarita's. Or maybe a nice spicy Indian fish curry. Lots of things > you could do with that theme. > > Quickly looking at the material again, here are some near term > suggested edits I can make. This is basic stuff on just a few pages > compared to the more major restructuring proposed earlier. > > a) Login, User Preferences, and HTML Editor > -- This could really be renamed a "Getting Started" page with four > sub-items: > 1) Login > 2) Setting User Preferences > 3) Setting HTML Editor mode > 4) Basics of Navigating the _Lime_Survey Administrative Interface > -- Item 4 would be pulled out of the following page on creating a > survey > -- some or all of the items can be on separate sub-pages, likely > only item 4 will be lengthy enough for that though > -- "rename" could mean simply retitling the top of the page but > keeping the TikiWiki page name for reasons outlined in the Manual > Guideline (ala translations) > -- A majority of the description of what the HTML editor is, how to > control it, how to use it, etc. should be pulled out into a separate > page. This page could be a fifth item in the outline above, a sub > page to the Basics page, or simply stand-alone page that is > hyperlinked to the HTML Editor mode section (note: standalone means it > is outside of the "structure" of the manual). But it deserves its own > page to be referenced from many locations. In fact, it should be made > a "hot word" in the TikiWiki so it is automatically linked when used > in text otherwise. > > b) Creating Surveys -- Introduction > -- We are now left with "Basic Survey elements" section on this > page (and the newly added video tutorial). The remaining part of this > page can be moved to the above "Getting Started" section as a fifth or > sixth element there with the same title. This page then simply > becomes an outline for its many sub-sections with little intro text. > > c) Creating a new survey and beyond > -- these next four pages are part of a basic "setting up a new > survey", following by "Creating a new group" and its subsection, and > then "adding a question / answers" sections with subsections. See > previous suggestions on restructuring here. > > Anything you want me to do from the above beyond simple editing of > pages will require my login get structure editing and new page > creation. This includes the more major restructuring presented earlier. > > If there are concerns with the more major changes being proposed (hard > to visualize; you all are so focused and embedded in 2.0 that are > being distracted thinking about 1.x now; etc), turn on "Page staging > and approval" and avoid accepting any of the changes I make until you > can review them in batches and more entirely. If not wanting to apply > this staging to everyone, partition users that should not be "staged" > into a specific group that you then allow to bypass staging. See the > TikiWiki "Wiki" admin page of options for more information. > > Randy > > > Randy Harr, Sevni wrote: >> Hi Guys, >> >> Sorry, I have been off line a few days. Busy times in Silicon Valley >> these past few weeks. Still interested although my immediate need >> project and time availability has since changed over the past month. >> Preparing for a big board meeting on Tuesday as it is. I will draft a >> response to Marcel's last email this weekend. >> >> Randy >> >> P.S. randy.harr for skype, surplusgadgets2003 for YahooIM, >> surplusgadgets for AIM. I can accept invitations. But honestly, email >> is usually the best as I use too many offices and computers and do not >> have equal access to instant services at all of them. >> >> Carsten Schmitz wrote: >> >>> Hello Randy, >>> >>> sorry for not very much reaction from my side so far. The time before >>> and after Christmas has been pretty crazy and I have been drawn out of >>> organizational things. >>> Please let me know how I can support you in your efforts. >>> Do you have some kind of Instant Messenger or Skype to contact you >>> directly? -- Best regards from Hamburg/Germany Carsten Schmitz LimeSurvey Project Leader car...@li... http://www.limesurvey.org |
From: Randy H. S. <ra...@se...> - 2009-01-19 20:16:53
|
Sounds good. Hopefully not too big a coding job to translate TikiWiki syntax to anwiki if needed. Your success seems partly rooted in great support for i18n. Did they start from scratch or with one of the existing code bases? In any case, have to give them my support as I am 1/2 Slovenian (2nd generation). All I can say is "Slovenski Narodni Dom" though as I spent much time growing up at weddings, funerals and the like. I really need to learn more languages :) Carsten Schmitz wrote: > Hello Randy, > > your proposals sounds good to me. Please get at it if you have the time. > I also made you an editor in the wiki so you can move things around. > I don't think staging is necessary. Please not also that I am just > testing a Wiki just for internationalization of documentation (Anwiki), > because I think that the current TikiWiki features for keeping > translations synchronized are not very good. I will keep you all posted > on the progress. > > Best regards > > Carsten Schmitz > > Randy Harr, Sevni schrieb: > >> Just checked out your updates to the Manual Guidelines page. >> >> Cookbook, Limes. Around here that usually means Tequila and >> Margarita's. Or maybe a nice spicy Indian fish curry. Lots of things >> you could do with that theme. >> >> Quickly looking at the material again, here are some near term >> suggested edits I can make. This is basic stuff on just a few pages >> compared to the more major restructuring proposed earlier. >> >> a) Login, User Preferences, and HTML Editor >> -- This could really be renamed a "Getting Started" page with four >> sub-items: >> 1) Login >> 2) Setting User Preferences >> 3) Setting HTML Editor mode >> 4) Basics of Navigating the _Lime_Survey Administrative Interface >> -- Item 4 would be pulled out of the following page on creating a >> survey >> -- some or all of the items can be on separate sub-pages, likely >> only item 4 will be lengthy enough for that though >> -- "rename" could mean simply retitling the top of the page but >> keeping the TikiWiki page name for reasons outlined in the Manual >> Guideline (ala translations) >> -- A majority of the description of what the HTML editor is, how to >> control it, how to use it, etc. should be pulled out into a separate >> page. This page could be a fifth item in the outline above, a sub >> page to the Basics page, or simply stand-alone page that is >> hyperlinked to the HTML Editor mode section (note: standalone means it >> is outside of the "structure" of the manual). But it deserves its own >> page to be referenced from many locations. In fact, it should be made >> a "hot word" in the TikiWiki so it is automatically linked when used >> in text otherwise. >> >> b) Creating Surveys -- Introduction >> -- We are now left with "Basic Survey elements" section on this >> page (and the newly added video tutorial). The remaining part of this >> page can be moved to the above "Getting Started" section as a fifth or >> sixth element there with the same title. This page then simply >> becomes an outline for its many sub-sections with little intro text. >> >> c) Creating a new survey and beyond >> -- these next four pages are part of a basic "setting up a new >> survey", following by "Creating a new group" and its subsection, and >> then "adding a question / answers" sections with subsections. See >> previous suggestions on restructuring here. >> >> Anything you want me to do from the above beyond simple editing of >> pages will require my login get structure editing and new page >> creation. This includes the more major restructuring presented earlier. >> >> If there are concerns with the more major changes being proposed (hard >> to visualize; you all are so focused and embedded in 2.0 that are >> being distracted thinking about 1.x now; etc), turn on "Page staging >> and approval" and avoid accepting any of the changes I make until you >> can review them in batches and more entirely. If not wanting to apply >> this staging to everyone, partition users that should not be "staged" >> into a specific group that you then allow to bypass staging. See the >> TikiWiki "Wiki" admin page of options for more information. >> >> Randy >> >> >> Randy Harr, Sevni wrote: >> >>> Hi Guys, >>> >>> Sorry, I have been off line a few days. Busy times in Silicon Valley >>> these past few weeks. Still interested although my immediate need >>> project and time availability has since changed over the past month. >>> Preparing for a big board meeting on Tuesday as it is. I will draft a >>> response to Marcel's last email this weekend. >>> >>> Randy >>> >>> P.S. randy.harr for skype, surplusgadgets2003 for YahooIM, >>> surplusgadgets for AIM. I can accept invitations. But honestly, email >>> is usually the best as I use too many offices and computers and do not >>> have equal access to instant services at all of them. >>> >>> Carsten Schmitz wrote: >>> >>> >>>> Hello Randy, >>>> >>>> sorry for not very much reaction from my side so far. The time before >>>> and after Christmas has been pretty crazy and I have been drawn out of >>>> organizational things. >>>> Please let me know how I can support you in your efforts. >>>> Do you have some kind of Instant Messenger or Skype to contact you >>>> directly? >>>> > > |
From: Randy H. S. <ra...@se...> - 2009-01-20 09:17:48
|
OK, I will get started. Above all, please speak up on changes that seem incorrect, inaccurate, or inappropriate for translation, historic methods or other reasons. My focus is helping survey developers who are not programmers, daily users, or necessarily computer experts. Thanks for letting me help your group reach that goal. Key is I have limited experience writing manuals and software that can be easily translated to 50+ languages as you support now. My history, while worldwide, has been mostly in making and selling software for engineers who had college instruction in English and can operate in an English software environment. So while I am surrounded by people such as yourselves that are multi-multi-lingual, my focus will naturally fall towards helping get the concept across clearly to native-English readers. So I look forward to you helping me understand where that ideal conflicts with i18n issues. Hopefully, we can all converge on a manual style that works for everyone as well. And be patient as I even vacillate on the right balance of graphics, screen captures, and other techniques to help get the message across in an interesting and proficient way. Bob, Marcel, Carsten and others should continue to speak-up often and openly as I try to come up to speed with your development culture. I would encourage we start adding information and external links to technology for writing better surveys as well. After all, it is not just the software but the method and language used to ask questions that are key to being successful. Randy Carsten Schmitz wrote: > Hello Randy, > > your proposals sounds good to me. Please get at it if you have the time. > I also made you an editor in the wiki so you can move things around. > I don't think staging is necessary. Please not also that I am just > testing a Wiki just for internationalization of documentation (Anwiki), > because I think that the current TikiWiki features for keeping > translations synchronized are not very good. I will keep you all posted > on the progress. > > Best regards > > Carsten Schmitz > > Randy Harr, Sevni schrieb: > >> Just checked out your updates to the Manual Guidelines page. >> >> Cookbook, Limes. Around here that usually means Tequila and >> Margarita's. Or maybe a nice spicy Indian fish curry. Lots of things >> you could do with that theme. >> >> Quickly looking at the material again, here are some near term >> suggested edits I can make. This is basic stuff on just a few pages >> compared to the more major restructuring proposed earlier. >> >> a) Login, User Preferences, and HTML Editor >> -- This could really be renamed a "Getting Started" page with four >> sub-items: >> 1) Login >> 2) Setting User Preferences >> 3) Setting HTML Editor mode >> 4) Basics of Navigating the _Lime_Survey Administrative Interface >> -- Item 4 would be pulled out of the following page on creating a >> survey >> -- some or all of the items can be on separate sub-pages, likely >> only item 4 will be lengthy enough for that though >> -- "rename" could mean simply retitling the top of the page but >> keeping the TikiWiki page name for reasons outlined in the Manual >> Guideline (ala translations) >> -- A majority of the description of what the HTML editor is, how to >> control it, how to use it, etc. should be pulled out into a separate >> page. This page could be a fifth item in the outline above, a sub >> page to the Basics page, or simply stand-alone page that is >> hyperlinked to the HTML Editor mode section (note: standalone means it >> is outside of the "structure" of the manual). But it deserves its own >> page to be referenced from many locations. In fact, it should be made >> a "hot word" in the TikiWiki so it is automatically linked when used >> in text otherwise. >> >> b) Creating Surveys -- Introduction >> -- We are now left with "Basic Survey elements" section on this >> page (and the newly added video tutorial). The remaining part of this >> page can be moved to the above "Getting Started" section as a fifth or >> sixth element there with the same title. This page then simply >> becomes an outline for its many sub-sections with little intro text. >> >> c) Creating a new survey and beyond >> -- these next four pages are part of a basic "setting up a new >> survey", following by "Creating a new group" and its subsection, and >> then "adding a question / answers" sections with subsections. See >> previous suggestions on restructuring here. >> >> Anything you want me to do from the above beyond simple editing of >> pages will require my login get structure editing and new page >> creation. This includes the more major restructuring presented earlier. >> >> If there are concerns with the more major changes being proposed (hard >> to visualize; you all are so focused and embedded in 2.0 that are >> being distracted thinking about 1.x now; etc), turn on "Page staging >> and approval" and avoid accepting any of the changes I make until you >> can review them in batches and more entirely. If not wanting to apply >> this staging to everyone, partition users that should not be "staged" >> into a specific group that you then allow to bypass staging. See the >> TikiWiki "Wiki" admin page of options for more information. >> >> Randy >> >> >> Randy Harr, Sevni wrote: >> >>> Hi Guys, >>> >>> Sorry, I have been off line a few days. Busy times in Silicon Valley >>> these past few weeks. Still interested although my immediate need >>> project and time availability has since changed over the past month. >>> Preparing for a big board meeting on Tuesday as it is. I will draft a >>> response to Marcel's last email this weekend. >>> >>> Randy >>> >>> P.S. randy.harr for skype, surplusgadgets2003 for YahooIM, >>> surplusgadgets for AIM. I can accept invitations. But honestly, email >>> is usually the best as I use too many offices and computers and do not >>> have equal access to instant services at all of them. >>> >>> Carsten Schmitz wrote: >>> >>> >>>> Hello Randy, >>>> >>>> sorry for not very much reaction from my side so far. The time before >>>> and after Christmas has been pretty crazy and I have been drawn out of >>>> organizational things. >>>> Please let me know how I can support you in your efforts. >>>> Do you have some kind of Instant Messenger or Skype to contact you >>>> directly? >>>> > > |
From: Marcel M. (Limesurvey) <mar...@li...> - 2009-01-20 10:19:37
|
I totally agree with everything Randy mentioned. I will give my best to help. Randy, from my experience it is often very useful to take a look at the latest changes in the wiki (see http://docs.limesurvey.org/tiki-lastchanges.php). If I change anything you made I will always try to leave a comment in the change log so you know what has been changed and why. If you have any questions feel free to ask. Regards, Marcel Randy Harr, Sevni schrieb: > OK, I will get started. Above all, please speak up on changes that > seem incorrect, inaccurate, or inappropriate for translation, historic > methods or other reasons. > > My focus is helping survey developers who are not programmers, daily > users, or necessarily computer experts. Thanks for letting me help > your group reach that goal. > > Key is I have limited experience writing manuals and software that can > be easily translated to 50+ languages as you support now. My history, > while worldwide, has been mostly in making and selling software for > engineers who had college instruction in English and can operate in an > English software environment. So while I am surrounded by people such > as yourselves that are multi-multi-lingual, my focus will naturally > fall towards helping get the concept across clearly to native-English > readers. So I look forward to you helping me understand where that > ideal conflicts with i18n issues. > > Hopefully, we can all converge on a manual style that works for > everyone as well. And be patient as I even vacillate on the right > balance of graphics, screen captures, and other techniques to help get > the message across in an interesting and proficient way. Bob, Marcel, > Carsten and others should continue to speak-up often and openly as I > try to come up to speed with your development culture. > > I would encourage we start adding information and external links to > technology for writing better surveys as well. After all, it is not > just the software but the method and language used to ask questions > that are key to being successful. > > Randy > > > Carsten Schmitz wrote: >> Hello Randy, >> >> your proposals sounds good to me. Please get at it if you have the time. >> I also made you an editor in the wiki so you can move things around. >> I don't think staging is necessary. Please not also that I am just >> testing a Wiki just for internationalization of documentation (Anwiki), >> because I think that the current TikiWiki features for keeping >> translations synchronized are not very good. I will keep you all posted >> on the progress. >> >> Best regards >> >> Carsten Schmitz >> >> Randy Harr, Sevni schrieb: >> >>> Just checked out your updates to the Manual Guidelines page. >>> >>> Cookbook, Limes. Around here that usually means Tequila and >>> Margarita's. Or maybe a nice spicy Indian fish curry. Lots of things >>> you could do with that theme. >>> >>> Quickly looking at the material again, here are some near term >>> suggested edits I can make. This is basic stuff on just a few pages >>> compared to the more major restructuring proposed earlier. >>> >>> a) Login, User Preferences, and HTML Editor >>> -- This could really be renamed a "Getting Started" page with four >>> sub-items: >>> 1) Login >>> 2) Setting User Preferences >>> 3) Setting HTML Editor mode >>> 4) Basics of Navigating the _Lime_Survey Administrative Interface >>> -- Item 4 would be pulled out of the following page on creating a >>> survey >>> -- some or all of the items can be on separate sub-pages, likely >>> only item 4 will be lengthy enough for that though >>> -- "rename" could mean simply retitling the top of the page but >>> keeping the TikiWiki page name for reasons outlined in the Manual >>> Guideline (ala translations) >>> -- A majority of the description of what the HTML editor is, how to >>> control it, how to use it, etc. should be pulled out into a separate >>> page. This page could be a fifth item in the outline above, a sub >>> page to the Basics page, or simply stand-alone page that is >>> hyperlinked to the HTML Editor mode section (note: standalone means it >>> is outside of the "structure" of the manual). But it deserves its own >>> page to be referenced from many locations. In fact, it should be made >>> a "hot word" in the TikiWiki so it is automatically linked when used >>> in text otherwise. >>> >>> b) Creating Surveys -- Introduction >>> -- We are now left with "Basic Survey elements" section on this >>> page (and the newly added video tutorial). The remaining part of this >>> page can be moved to the above "Getting Started" section as a fifth or >>> sixth element there with the same title. This page then simply >>> becomes an outline for its many sub-sections with little intro text. >>> >>> c) Creating a new survey and beyond >>> -- these next four pages are part of a basic "setting up a new >>> survey", following by "Creating a new group" and its subsection, and >>> then "adding a question / answers" sections with subsections. See >>> previous suggestions on restructuring here. >>> >>> Anything you want me to do from the above beyond simple editing of >>> pages will require my login get structure editing and new page >>> creation. This includes the more major restructuring presented earlier. >>> >>> If there are concerns with the more major changes being proposed (hard >>> to visualize; you all are so focused and embedded in 2.0 that are >>> being distracted thinking about 1.x now; etc), turn on "Page staging >>> and approval" and avoid accepting any of the changes I make until you >>> can review them in batches and more entirely. If not wanting to apply >>> this staging to everyone, partition users that should not be "staged" >>> into a specific group that you then allow to bypass staging. See the >>> TikiWiki "Wiki" admin page of options for more information. >>> >>> Randy >>> >>> >>> Randy Harr, Sevni wrote: >>> >>>> Hi Guys, >>>> >>>> Sorry, I have been off line a few days. Busy times in Silicon Valley >>>> these past few weeks. Still interested although my immediate need >>>> project and time availability has since changed over the past month. >>>> Preparing for a big board meeting on Tuesday as it is. I will draft a >>>> response to Marcel's last email this weekend. >>>> >>>> Randy >>>> >>>> P.S. randy.harr for skype, surplusgadgets2003 for YahooIM, >>>> surplusgadgets for AIM. I can accept invitations. But honestly, email >>>> is usually the best as I use too many offices and computers and do not >>>> have equal access to instant services at all of them. >>>> >>>> Carsten Schmitz wrote: >>>> >>>> >>>>> Hello Randy, >>>>> >>>>> sorry for not very much reaction from my side so far. The time before >>>>> and after Christmas has been pretty crazy and I have been drawn out of >>>>> organizational things. >>>>> Please let me know how I can support you in your efforts. >>>>> Do you have some kind of Instant Messenger or Skype to contact you >>>>> directly? >>>>> >> >> > ------------------------------------------------------------------------ > > ------------------------------------------------------------------------------ > This SF.net email is sponsored by: > SourcForge Community > SourceForge wants to tell your story. > http://p.sf.net/sfu/sf-spreadtheword > ------------------------------------------------------------------------ > > _______________________________________________ > limesurvey-developers mailing list > lim...@li... > https://lists.sourceforge.net/lists/listinfo/limesurvey-developers > |
From: Thibault Le M. <Thi...@su...> - 2009-01-20 11:12:39
|
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"> <html> <head> <meta content="text/html;charset=ISO-8859-1" http-equiv="Content-Type"> </head> <body bgcolor="#ffffff" text="#000000"> Hi all,<br> <br> I have not read all the thread, but I'm very happy to see some good work is in progress on the documentation: an aspect of the LS project we really need to improve.<br> That's a huge work and I/We really appreciate any help, good ideas, ...<br> <br> So thank you for your proposal, and I'll try to have a look at the doc and will give you feedback.<br> <br> Thibault<br> <br> <br> <br> Marcel Minke (Limesurvey) a écrit : <blockquote cite="mid:497...@li..." type="cite"> <pre wrap="">I totally agree with everything Randy mentioned. I will give my best to help. Randy, from my experience it is often very useful to take a look at the latest changes in the wiki (see <a class="moz-txt-link-freetext" href="http://docs.limesurvey.org/tiki-lastchanges.php">http://docs.limesurvey.org/tiki-lastchanges.php</a>). If I change anything you made I will always try to leave a comment in the change log so you know what has been changed and why. If you have any questions feel free to ask. Regards, Marcel Randy Harr, Sevni schrieb: </pre> <blockquote type="cite"> <pre wrap="">OK, I will get started. Above all, please speak up on changes that seem incorrect, inaccurate, or inappropriate for translation, historic methods or other reasons. My focus is helping survey developers who are not programmers, daily users, or necessarily computer experts. Thanks for letting me help your group reach that goal. Key is I have limited experience writing manuals and software that can be easily translated to 50+ languages as you support now. My history, while worldwide, has been mostly in making and selling software for engineers who had college instruction in English and can operate in an English software environment. So while I am surrounded by people such as yourselves that are multi-multi-lingual, my focus will naturally fall towards helping get the concept across clearly to native-English readers. So I look forward to you helping me understand where that ideal conflicts with i18n issues. Hopefully, we can all converge on a manual style that works for everyone as well. And be patient as I even vacillate on the right balance of graphics, screen captures, and other techniques to help get the message across in an interesting and proficient way. Bob, Marcel, Carsten and others should continue to speak-up often and openly as I try to come up to speed with your development culture. I would encourage we start adding information and external links to technology for writing better surveys as well. After all, it is not just the software but the method and language used to ask questions that are key to being successful. Randy Carsten Schmitz wrote: </pre> <blockquote type="cite"> <pre wrap="">Hello Randy, your proposals sounds good to me. Please get at it if you have the time. I also made you an editor in the wiki so you can move things around. I don't think staging is necessary. Please not also that I am just testing a Wiki just for internationalization of documentation (Anwiki), because I think that the current TikiWiki features for keeping translations synchronized are not very good. I will keep you all posted on the progress. Best regards Carsten Schmitz Randy Harr, Sevni schrieb: </pre> <blockquote type="cite"> <pre wrap="">Just checked out your updates to the Manual Guidelines page. Cookbook, Limes. Around here that usually means Tequila and Margarita's. Or maybe a nice spicy Indian fish curry. Lots of things you could do with that theme. Quickly looking at the material again, here are some near term suggested edits I can make. This is basic stuff on just a few pages compared to the more major restructuring proposed earlier. a) Login, User Preferences, and HTML Editor -- This could really be renamed a "Getting Started" page with four sub-items: 1) Login 2) Setting User Preferences 3) Setting HTML Editor mode 4) Basics of Navigating the _Lime_Survey Administrative Interface -- Item 4 would be pulled out of the following page on creating a survey -- some or all of the items can be on separate sub-pages, likely only item 4 will be lengthy enough for that though -- "rename" could mean simply retitling the top of the page but keeping the TikiWiki page name for reasons outlined in the Manual Guideline (ala translations) -- A majority of the description of what the HTML editor is, how to control it, how to use it, etc. should be pulled out into a separate page. This page could be a fifth item in the outline above, a sub page to the Basics page, or simply stand-alone page that is hyperlinked to the HTML Editor mode section (note: standalone means it is outside of the "structure" of the manual). But it deserves its own page to be referenced from many locations. In fact, it should be made a "hot word" in the TikiWiki so it is automatically linked when used in text otherwise. b) Creating Surveys -- Introduction -- We are now left with "Basic Survey elements" section on this page (and the newly added video tutorial). The remaining part of this page can be moved to the above "Getting Started" section as a fifth or sixth element there with the same title. This page then simply becomes an outline for its many sub-sections with little intro text. c) Creating a new survey and beyond -- these next four pages are part of a basic "setting up a new survey", following by "Creating a new group" and its subsection, and then "adding a question / answers" sections with subsections. See previous suggestions on restructuring here. Anything you want me to do from the above beyond simple editing of pages will require my login get structure editing and new page creation. This includes the more major restructuring presented earlier. If there are concerns with the more major changes being proposed (hard to visualize; you all are so focused and embedded in 2.0 that are being distracted thinking about 1.x now; etc), turn on "Page staging and approval" and avoid accepting any of the changes I make until you can review them in batches and more entirely. If not wanting to apply this staging to everyone, partition users that should not be "staged" into a specific group that you then allow to bypass staging. See the TikiWiki "Wiki" admin page of options for more information. Randy Randy Harr, Sevni wrote: </pre> <blockquote type="cite"> <pre wrap="">Hi Guys, Sorry, I have been off line a few days. Busy times in Silicon Valley these past few weeks. Still interested although my immediate need project and time availability has since changed over the past month. Preparing for a big board meeting on Tuesday as it is. I will draft a response to Marcel's last email this weekend. Randy P.S. randy.harr for skype, surplusgadgets2003 for YahooIM, surplusgadgets for AIM. I can accept invitations. But honestly, email is usually the best as I use too many offices and computers and do not have equal access to instant services at all of them. Carsten Schmitz wrote: </pre> <blockquote type="cite"> <pre wrap="">Hello Randy, sorry for not very much reaction from my side so far. The time before and after Christmas has been pretty crazy and I have been drawn out of organizational things. Please let me know how I can support you in your efforts. Do you have some kind of Instant Messenger or Skype to contact you directly? </pre> </blockquote> </blockquote> </blockquote> <pre wrap=""> </pre> </blockquote> <pre wrap="">------------------------------------------------------------------------ ------------------------------------------------------------------------------ This SF.net email is sponsored by: SourcForge Community SourceForge wants to tell your story. <a class="moz-txt-link-freetext" href="http://p.sf.net/sfu/sf-spreadtheword">http://p.sf.net/sfu/sf-spreadtheword</a> ------------------------------------------------------------------------ _______________________________________________ limesurvey-developers mailing list <a class="moz-txt-link-abbreviated" href="mailto:lim...@li...">lim...@li...</a> <a class="moz-txt-link-freetext" href="https://lists.sourceforge.net/lists/listinfo/limesurvey-developers">https://lists.sourceforge.net/lists/listinfo/limesurvey-developers</a> </pre> </blockquote> <pre wrap=""><!----> ------------------------------------------------------------------------------ This SF.net email is sponsored by: SourcForge Community SourceForge wants to tell your story. <a class="moz-txt-link-freetext" href="http://p.sf.net/sfu/sf-spreadtheword">http://p.sf.net/sfu/sf-spreadtheword</a> _______________________________________________ limesurvey-developers mailing list <a class="moz-txt-link-abbreviated" href="mailto:lim...@li...">lim...@li...</a> <a class="moz-txt-link-freetext" href="https://lists.sourceforge.net/lists/listinfo/limesurvey-developers">https://lists.sourceforge.net/lists/listinfo/limesurvey-developers</a> </pre> </blockquote> <br> </body> </html> |
From: Randy H. S. <ra...@se...> - 2009-01-24 03:40:44
|
* Put up "construction notice" on "English Instructions for LimeSurvey" home page and its "English Manual" shadow page that was already a Structure (i.e. Book) * Created Development (Development2) and Wiki Home (LimeSurvey Documentation Wiki2) shadow pages that are top levels of new Books (Structures). Made them redirects to the main pages. * Put most English pages into one of these three Books * Edited the "English Manual" Structure (Book) to reflect the previously suggested reordering and indexing of pages * Corrected language designation of some Wiki pages that were incorrect (listed as English incorrectly) * Minor cleanup of pre-existing pages as part of the review process (see last changes / history for more info) *Note:* a TikiWiki admin should turn on the Wiki feature: admin-> wiki -> Open page as structure so that pages open with structure navigation by default. Otherwise, intermediate pages with only a {toc} will appear blank. This does not affect pages not part of a structure. * Details ==========* The permissions were not setup in TikiWiki to allow me to create a Structure top page from an existing page. So a shadow page that owns the structure was created in two cases. These shadow pages were redirected back to the main page. And then an auto table of content tag ({tag}) was added to the main page that referenced the new shadow structure (page). Eventually this will be cleaned up and merged back by someone with the right permissions. The "English Instructions for LimeSurvey" already had a shadow page named "English Manual". This was made to conform to this shadow mechanism of the two new books already mentioned. (*Note:* I held off doing the insertion of the {toc} on the Wiki Home page to avoid disruption at the top level. But it can be added there easily. Simply add the following two lines to the top of the page: {DIV(float=>right)}^Structured Table of Contents (automatic):{toc structID=170}^{DIV} -=Original Page (Historical)=- See the shadow page <http://docs.limesurvey.org/tiki-index.php?page=LimeSurvey+Documentation+Wiki2&page_ref_id=170> for an example of what this will look like. The "Orphan Pages" feature in TikiWiki is part of the Structure mechanism and meant to show those pages not linked into a Book. By making Structures out of the two main pages (Development, Wiki Home) in addition to the existing English Manual, there is now a Structure (Book) home for all English pages. Thus "Orphan Pages" can be used to find English documentation pages created but not yet linked into one of the three main books and their table of contents. Most pages are now linked into one of these three Structures; all will eventually be. We are down to 20 English pages not linked into one of the three Books from 150 originally. Many pages that were totally orphaned are being discovered. Some that are likely deprecated and can be deleted or redirected. As mentioned in the initial proposal, the advantage of using Structures is the {toc} tag can be used to keep the outline and links to other pages automatic. As new features or pages are added, they simply need to be added into the Structure in the appropriate place. Then the referencing page will automatically list them. {toc} parameters such as "maxdepth", "showdesc", etc. will be added as necessary to help create nicer navigation references in certain pages. Now structure edits, splitting of existing pages into multiple pages, and similar changes can easily occur-- without out dating higher level content pages. As an example, as tasked today, will work to merge and split the two Templates pages into likely 4 pages with a top page on the overall subject of Templates (including styles) that references them. The original two names will be redirects to the new, single top level page. Let's see if I can get to that this weekend. As we go along, everyone should review pages for missing content and add new headings or new pages to the structure as placeholders to identify where content is missing. Due to gaps in the documentation now appearing, it may be better to focus on editing the current manual into a complete reference manual first and then come back looking for the cookbook, process descriptions to more gently introduce topics to new users of various levels. |