RECOUP/site/Help/WikiMaintenance: Difference between revisions

From OER in Education
< RECOUP‎ | site
m (Names for handout pages)
 
m (1 revision: Import and update from manual.recoup.educ.cam.ac.uk, CC BY-NC-SA - RECOUP)
 
(92 intermediate revisions by the same user not shown)
Line 1: Line 1:
<noinclude>{{RECOUP_header|Help:WikiMaintenance}}</noinclude>= Notes and changes =
<noinclude>{{RECOUP_header|Help:WikiMaintenance}}</noinclude>
= Notes and changes =
 
 
== Recent additions and modifications to software (most recent first) ==
* Upgraded to 1.14.0 [[RECOUP/site/User/Bjoern|Bjoern]] 15:26, 7 May 2009 (UTC)
* Installed references extension because this was used on [[RECOUP/Ethical issues/Participant Consent Form/handout|this page]]. Further info on http://www.mediawiki.org/wiki/Extension:Cite/Cite.php --[[RECOUP/site/User/Bjoern|Bjoern]] 21:15, 22 September 2008 (UTC)
* Pdf/Odt export extension installed and working. Each manual page is now downloadable as automatically generated Pdf/Odt. --[[RECOUP/site/User/Bjoern|Bjoern]] 19:52, 21 September 2008 (UTC)
* Server move to http://manual.recoup.educ.cam.ac.uk complete and wiki editing enabled. --[[RECOUP/site/User/Bjoern|Bjoern]] 15:23, 21 September 2008 (UTC)
* Changed default settings so that numbering sections and justified paragraphs are default. --[[RECOUP/site/User/Bjoern|Bjoern]] 14:42, 13 September 2008 (UTC)
* Added a file size extension, so that download file sizes are now shown on download pages for presentation, see e.g. [[RECOUP/Community scoping/Sample Household Consensus Form|Community scoping/Sample Household Consensus Form]] --[[RECOUP/site/User/Bjoern|Bjoern]] 16:34, 11 September 2008 (UTC)
* On manual pages, I removed the redundant top page title (above the menu), see e.g. [[RECOUP/Introduction|Introduction]]. This change is made through [[Mediawiki:Common.css|Mediawiki:Common.css]], see [[RECOUP/site/Help/Administrators|Help:Administrators]]. --[[RECOUP/site/User/Bjoern|Bjoern]] 12:13, 7 September 2008 (UTC)
* Minor fix to mirroring scripts to get [[RECOUP/Session 4|Session 4]] working again. [[RECOUP/site/User/Bjoern|Bjoern]] 23:08, 25 August 2008 (UTC)
* There are now four new edit buttons above the edit box: <s>strike through</s>, <u>underline</u>, as well as for box and comment template. [[RECOUP/site/User/Bjoern|Bjoern]] 20:46, 23 August 2008 (UTC)
* Improvement to mirroring script / api, cf. [[RECOUP/Administrator Information|Administrator Information]]. [[RECOUP/site/User/Bjoern|Bjoern]] 15:21, 23 August 2008 (UTC)
* Added a new templates (see [[RECOUP/Administrator Information|Administrator Information]]): box (for participants reponses), comment (to make comments in main text visible). [[RECOUP/site/User/Bjoern|Bjoern]] 19:34, 22 August 2008 (UTC)
* Added a new template (see [[RECOUP/Administrator Information|Administrator Information]]) to generate page titles that won't print in pdf output (which is still to be added). Example in [[RECOUP/Session 7|Session 7]] and [[RECOUP/Session 2|Session 2]], that show page header, page title, and page contents nicely in sequence. (Headings within a page/session can thus start with the top level heading: <u>= ... =</u>, which produces a good structure for the table of contents.). [[RECOUP/site/User/Bjoern|Bjoern]] 14:10, 22 August 2008 (UTC)
* I've added this image [[Image:RECOUP_RECOUP book.jpg|20px]] to the manual header. [[RECOUP/site/User/Bjoern|Bjoern]] 20:12, 21 August 2008 (UTC)
* File uploads are now enabled. [[RECOUP/site/User/Bjoern|Bjoern]] 20:14, 21 August 2008 (UTC)
 
== Overall changes to wiki text (newest last) ==
* The [[Template:RECOUP/Header|Template:Header]] was changed to accommodated the new page titles, and all page titles were changed accordingly. --[[RECOUP/site/User/Bjoern|Bjoern]] 20:04, 1 September 2008 (UTC)
* [[RECOUP/site/User/Bjoern|Bjoern]] modified the [[RECOUP/Introduction|Introduction]] to include the text from the about page. Needs further work. --[[RECOUP/site/User/Bjoern|Bjoern]] 20:04, 1 September 2008 (UTC)
* That's all the images uploaded. --[[RECOUP/site/User/Bjoern|Bjoern]] 14:48, 2 September 2008 (UTC)
* Changed the background image and the logo. Appearance now a little intense - I'll leave it for now, let me know what you think. --[[RECOUP/site/User/Bjoern|Bjoern]] 23:14, 3 September 2008 (UTC)
* I have floated the contents boxes to the right. This makes the pages a more compact. Otherwise the various wiki menus plus the page menu and toc take up all the space on the page, leaving no space for the actual manual text! Let me know what you think! --[[RECOUP/site/User/Bjoern|Bjoern]] 00:10, 4 September 2008 (UTC)
* I have now uploaded all handouts that I've had, see [[:Category:Handouts|:Category:Handouts]]. The handouts still need checking, and the formatting needs to be improved in places. --[[RECOUP/site/User/Bjoern|Bjoern]] 19:47, 5 September 2008 (UTC)
* I will go through the manual, and add comments where issues need to be address, e.g. about missing handouts. --[[RECOUP/site/User/Bjoern|Bjoern]] 19:50, 5 September 2008 (UTC)
* Have now added information about missing handouts. In the summary that Arathi sent, most of these were mentioned, so I genuinely don't have them. --[[RECOUP/site/User/Bjoern|Bjoern]] 20:40, 5 September 2008 (UTC)
* Redesigned alternative header, cf. [[RECOUP/Qualitative research|Qualitative research]]. Suggestion is to use large header for the first page of the manual, and the smaller header for all other pages. The alternative header also has the content box floated to the left, and inserted into the text. I am still tryint to see where the content box fits in best - let me know what you think. --[[RECOUP/site/User/Bjoern|Bjoern]] 08:35, 8 September 2008 (UTC)
* [[:Category:Documents|:Category:Documents]]: All remaining handouts have been uploaded (in all required formats), with image preview. --[[RECOUP/site/User/Bjoern|Bjoern]] 18:33, 9 September 2008 (UTC)
* [[:Category:Presentations|:Category:Presentations]] now lists all presentations in as much as I have got all powerpoints. Powerpoints still need to be uploaded and converted (subject to go ahead on the version of the logo and placement of CC badge). --[[RECOUP/site/User/Bjoern|Bjoern]] 18:33, 9 September 2008 (UTC)
 
= Additional images: =
[[Image:RECOUP_Expectations.jpg|100px]]
[[Image:RECOUP_Ground rules.jpg|100px]]
[[Image:RECOUP_Group setting.jpg|100px]]
[[Image:RECOUP_Researcher photography 1.jpg|100px]]
[[Image:RECOUP_Researcher photography.jpg|100px]]
 
 


[[User:Bjoern|Bjoern]] says: We have to decide whether the front page of the wiki emphasises the manual (i.e. "the manual is the main part of this wiki") or collaboration (i.e. "the manual is mentioned on the front page, but there are other important parts to the wiki, such as pages for individual workshops".) [[User:Bjoern|Bjoern]] 10:55, 21 August 2008 (UTC)


Recent additions and modifications to software:
* Minor fix to mirroring scripts to get [[Session 4]] working again. [[User:Bjoern|Bjoern]] 23:08, 25 August 2008 (UTC)
* There are now four new edit buttons above the edit box: <s>strike through</s>, <u>underline</u>, as well as for box and comment template. [[User:Bjoern|Bjoern]] 20:46, 23 August 2008 (UTC)
* Improvement to mirroring script / api, cf. [[Administrator Information]]. [[User:Bjoern|Bjoern]] 15:21, 23 August 2008 (UTC)
* Added a new templates (see [[Administrator Information]]): box (for participants reponses), comment (to make comments in main text visible). [[User:Bjoern|Bjoern]] 19:34, 22 August 2008 (UTC)
* Added a new template (see [[Administrator Information]]) to generate page titles that won't print in pdf output (which is still to be added). Example in [[Session 7]] and [[Session 2]], that show page header, page title, and page contents nicely in sequence. (Headings within a page/session can thus start with the top level heading: <u>= ... =</u>, which produces a good structure for the table of contents.). [[User:Bjoern|Bjoern]] 14:10, 22 August 2008 (UTC)
* I've added this image [[Image:RECOUP book.jpg|20px]] to the manual header. [[User:Bjoern|Bjoern]] 20:12, 21 August 2008 (UTC)
* File uploads are now enabled. [[User:Bjoern|Bjoern]] 20:14, 21 August 2008 (UTC)


= For administrators =


[[Administrator Information]]


= Discussion =
= Discussion =
Line 22: Line 51:
== Wiki front page ==
== Wiki front page ==


I've tried to clean up the front page. This should work better. I still have reservations against making the front page part of the manual: If the community is successful, the front page will place less emphasis on the 'original' manual, because there will be additional materials, experiences from workshops, translations etc. However, perhaps for now the front page should become the main page of the manual. What do you think? [[User:Bjoern|Bjoern]] 17:35, 22 August 2008 (UTC)
I've tried to clean up the front page. This should work better. I still have reservations against making the front page part of the manual: If the community is successful, the front page will place less emphasis on the 'original' manual, because there will be additional materials, experiences from workshops, translations etc. However, perhaps for now the front page should become the main page of the manual. What do you think? [[RECOUP/site/User/Bjoern|Bjoern]] 17:35, 22 August 2008 (UTC)


Yes, i agree that the front page should become the main page of the manual-- we need to 'hook' people in-- and then we can hope to see a community develop. tricky business! later today or early tomorrow i will send a more detailed mail with some suggestions on how to arrange various sessions (and alternative titles for the 'sessions') in the manual-- as a result of a long discussion that Roger and I had yesterday.
Yes, i agree that the front page should become the main page of the manual-- we need to 'hook' people in-- and then we can hope to see a community develop. tricky business! later today or early tomorrow i will send a more detailed mail with some suggestions on how to arrange various sessions (and alternative titles for the 'sessions') in the manual-- as a result of a long discussion that Roger and I had yesterday.


= Names for handout pages =
== Names for handout pages and styles for headings ==
 
See [[RECOUP/site/Help/Manual Style Guide|Help:Manual Style Guide]]


We need to find good page names for the powerpoints etc. They can't be too generic. The basic question is:
== User pages ==
* Are most handouts tied to specific sessions? '''or'''
* Are handouts used across several sessions?


If handouts are specific to sessions, then we should also use the 'subpage' feature. E.g.
I would recommend that you put some minimal information onto you 'user' pages, i.e.
* [[RECOUP/site/User/Nidhi|User:Nidhi]]
* [[RECOUP/site/User/Roger|User:Roger]]
* [[RECOUP/site/User/Arathi|User:Arathi]]
See [[RECOUP/site/User/Bjoern|User:Bjoern]] as an example. You may want to describe your role in the project in one sentence, and add a weblink to your homepage. You might like to add something like: "Registered users can contact me via my contact me via my talk page (<nowiki>[[Talk:RECOUP/site/User/Nidhi|User talk:Nidhi]]</nowiki>) or by email via <nowiki>[[Special:Emailuser/Nidhi|Special:Emailuser/Nidhi]]</nowiki>".


* Instead of '''<nowiki>[[example]]</nowiki> of a topic guide''' you could use '''<nowiki>[[Session 4/topic guide|example of a topic guide]]</nowiki>''' to give '''[[Session 4/topic guide|example of a topic guide]]'''
To try out email function: [[Special:Emailuser/Nidhi|Special:Emailuser/Nidhi]], [[Special:Emailuser/Roger|Special:Emailuser/Roger]], [[Special:Emailuser/Arathi|Special:Emailuser/Arathi]]  
* '''<nowiki>[[handout]] on 'Questions to be avoided'</nowiki>''' could be '''<nowiki>[[Session 4/questions to avoid|handout]] on questions to be avoided</nowiki>'''
* '''<nowiki>[[Powerpoint]] (semi-structured interviews_1)</nowiki>''' could be '''<nowiki>[[Session 4/semi-structured interviews|powerpoint on semi structured interviews]]</nowiki>'''


Ideally the page names would be short, so that they are not too hard to type. You can change the name of the link by using the vertical bar | .
I'll send you an email via the wiki now, so that you can see what this looks like!


Handouts should always have <nowiki>[[Category:Handouts]]</nowiki> on the page for the handout, so that they get gathered into the [["Category:Handouts|Handouts category]]. --[[User:Bjoern|Bjoern]] 14:21, 27 August 2008 (UTC)
--[[RECOUP/site/User/Bjoern|Bjoern]] 14:00, 30 August 2008 (UTC)
<noinclude>{{RECOUP_footer|Help:WikiMaintenance}}</noinclude><noinclude>[[Category:RECOUP]]</noinclude>
<noinclude>{{RECOUP_footer|Help:WikiMaintenance}}</noinclude><noinclude>[[Category:RECOUP]]</noinclude>

Latest revision as of 12:16, 5 February 2015

Notes and changes

Recent additions and modifications to software (most recent first)

  • Upgraded to 1.14.0 Bjoern 15:26, 7 May 2009 (UTC)
  • Installed references extension because this was used on this page. Further info on http://www.mediawiki.org/wiki/Extension:Cite/Cite.php --Bjoern 21:15, 22 September 2008 (UTC)
  • Pdf/Odt export extension installed and working. Each manual page is now downloadable as automatically generated Pdf/Odt. --Bjoern 19:52, 21 September 2008 (UTC)
  • Server move to http://manual.recoup.educ.cam.ac.uk complete and wiki editing enabled. --Bjoern 15:23, 21 September 2008 (UTC)
  • Changed default settings so that numbering sections and justified paragraphs are default. --Bjoern 14:42, 13 September 2008 (UTC)
  • Added a file size extension, so that download file sizes are now shown on download pages for presentation, see e.g. Community scoping/Sample Household Consensus Form --Bjoern 16:34, 11 September 2008 (UTC)
  • On manual pages, I removed the redundant top page title (above the menu), see e.g. Introduction. This change is made through Mediawiki:Common.css, see Help:Administrators. --Bjoern 12:13, 7 September 2008 (UTC)
  • Minor fix to mirroring scripts to get Session 4 working again. Bjoern 23:08, 25 August 2008 (UTC)
  • There are now four new edit buttons above the edit box: strike through, underline, as well as for box and comment template. Bjoern 20:46, 23 August 2008 (UTC)
  • Improvement to mirroring script / api, cf. Administrator Information. Bjoern 15:21, 23 August 2008 (UTC)
  • Added a new templates (see Administrator Information): box (for participants reponses), comment (to make comments in main text visible). Bjoern 19:34, 22 August 2008 (UTC)
  • Added a new template (see Administrator Information) to generate page titles that won't print in pdf output (which is still to be added). Example in Session 7 and Session 2, that show page header, page title, and page contents nicely in sequence. (Headings within a page/session can thus start with the top level heading: = ... =, which produces a good structure for the table of contents.). Bjoern 14:10, 22 August 2008 (UTC)
  • I've added this image RECOUP RECOUP book.jpg to the manual header. Bjoern 20:12, 21 August 2008 (UTC)
  • File uploads are now enabled. Bjoern 20:14, 21 August 2008 (UTC)

Overall changes to wiki text (newest last)

  • The Template:Header was changed to accommodated the new page titles, and all page titles were changed accordingly. --Bjoern 20:04, 1 September 2008 (UTC)
  • Bjoern modified the Introduction to include the text from the about page. Needs further work. --Bjoern 20:04, 1 September 2008 (UTC)
  • That's all the images uploaded. --Bjoern 14:48, 2 September 2008 (UTC)
  • Changed the background image and the logo. Appearance now a little intense - I'll leave it for now, let me know what you think. --Bjoern 23:14, 3 September 2008 (UTC)
  • I have floated the contents boxes to the right. This makes the pages a more compact. Otherwise the various wiki menus plus the page menu and toc take up all the space on the page, leaving no space for the actual manual text! Let me know what you think! --Bjoern 00:10, 4 September 2008 (UTC)
  • I have now uploaded all handouts that I've had, see :Category:Handouts. The handouts still need checking, and the formatting needs to be improved in places. --Bjoern 19:47, 5 September 2008 (UTC)
  • I will go through the manual, and add comments where issues need to be address, e.g. about missing handouts. --Bjoern 19:50, 5 September 2008 (UTC)
  • Have now added information about missing handouts. In the summary that Arathi sent, most of these were mentioned, so I genuinely don't have them. --Bjoern 20:40, 5 September 2008 (UTC)
  • Redesigned alternative header, cf. Qualitative research. Suggestion is to use large header for the first page of the manual, and the smaller header for all other pages. The alternative header also has the content box floated to the left, and inserted into the text. I am still tryint to see where the content box fits in best - let me know what you think. --Bjoern 08:35, 8 September 2008 (UTC)
  • :Category:Documents: All remaining handouts have been uploaded (in all required formats), with image preview. --Bjoern 18:33, 9 September 2008 (UTC)
  • :Category:Presentations now lists all presentations in as much as I have got all powerpoints. Powerpoints still need to be uploaded and converted (subject to go ahead on the version of the logo and placement of CC badge). --Bjoern 18:33, 9 September 2008 (UTC)

Additional images:

RECOUP Expectations.jpg RECOUP Ground rules.jpg RECOUP Group setting.jpg RECOUP Researcher photography 1.jpg RECOUP Researcher photography.jpg




Discussion

Hi Bjoern, the image you have added looks good. I am a little concerned about the visual "clutter" on the main page. I find it too distracting from the main purpose- to showcase the manual. Any ideas on how this can be handled? N

Wiki front page

I've tried to clean up the front page. This should work better. I still have reservations against making the front page part of the manual: If the community is successful, the front page will place less emphasis on the 'original' manual, because there will be additional materials, experiences from workshops, translations etc. However, perhaps for now the front page should become the main page of the manual. What do you think? Bjoern 17:35, 22 August 2008 (UTC)

Yes, i agree that the front page should become the main page of the manual-- we need to 'hook' people in-- and then we can hope to see a community develop. tricky business! later today or early tomorrow i will send a more detailed mail with some suggestions on how to arrange various sessions (and alternative titles for the 'sessions') in the manual-- as a result of a long discussion that Roger and I had yesterday.

Names for handout pages and styles for headings

See Help:Manual Style Guide

User pages

I would recommend that you put some minimal information onto you 'user' pages, i.e.

See User:Bjoern as an example. You may want to describe your role in the project in one sentence, and add a weblink to your homepage. You might like to add something like: "Registered users can contact me via my contact me via my talk page ([[Talk:RECOUP/site/User/Nidhi|User talk:Nidhi]]) or by email via [[Special:Emailuser/Nidhi|Special:Emailuser/Nidhi]]".

To try out email function: Special:Emailuser/Nidhi, Special:Emailuser/Roger, Special:Emailuser/Arathi

I'll send you an email via the wiki now, so that you can see what this looks like!

--Bjoern 14:00, 30 August 2008 (UTC)


Cc-by-nc-sa-narrow.png Singal, N., and Jeffery, R. (2008). Qualitative Research Skills Workshop: A Facilitator's Reference Manual, http://oer.educ.cam.ac.uk/wiki/RECOUP, Cambridge: RECOUP (Research Consortium on Educational Outcomes and Poverty, http://recoup.educ.cam.ac.uk/). CC BY-NC-SA 4.0. (original page)