Difference between revisions of "FOSS Stages"

From Process | Spoken-Tutorial
Jump to: navigation, search
(Script-Writing Instructions)
(Stage 2: Create a template for the slides)
 
(45 intermediate revisions by 2 users not shown)
Line 1: Line 1:
 
==Stages in the life-cycle of Spoken Tutorials==
 
==Stages in the life-cycle of Spoken Tutorials==
 
<blockquote style="background-color: cornsilk; border: solid thin grey;">
 
<blockquote style="background-color: cornsilk; border: solid thin grey;">
[http://spoken-tutorial.org/process/index.php/FOSS_Stages/Checklist Click here to see the Guidelines Checklist]
+
[http://process.spoken-tutorial.org/index.php/FOSS_Stages/Checklist Click here to see the Guidelines Checklist]
 
</blockquote>
 
</blockquote>
 
===Before Creation: <u>Checklist Test</u>===
 
===Before Creation: <u>Checklist Test</u>===
Line 24: Line 24:
 
===After Checklist Test: <u>Creating accounts</u>===
 
===After Checklist Test: <u>Creating accounts</u>===
 
# Create an account for yourself on http://spoken-tutorial.org
 
# Create an account for yourself on http://spoken-tutorial.org
# Initimate the Project Manager heading Creation of Spoken Tutorials that you have done so
+
# You will receive a mail with an authentication link
 +
# Click on that link and complete the required verification
 +
# Login to the website using your '''username''' and '''password'''
 +
# Click on '''Creation''' tab and select '''Creation Dashboard''' from the drop-down
 +
# Click on '''"Add me as contributor"''' link
 +
# Initimate the Project Manager - Creation, that you have done so
 
# Share your '''username''' with her so that she can authenticate your role as '''contributor'''
 
# Share your '''username''' with her so that she can authenticate your role as '''contributor'''
# Once done, '''we will create''' an account for you on http://spoken-tutorial.org/script and share the details with you
+
# Once done, '''we will create''' an account for you on http://script.spoken-tutorial.org and share the details with you
  
 
For any assistance, please contact us.
 
For any assistance, please contact us.
 +
----
 +
 +
===Learning activity===
 +
# Go through the screencasting videos and learn how to create a '''screencast video''' using either one -
 +
#* [http://www.spoken-tutorial.org/show_video?tr=185&sval=1 recordMyDesktop ]
 +
#* [http://www.spoken-tutorial.org/show_video?tr=198&sval=1 CamStudio]
 +
# Create a '''sample 2 min video''' and submit for Admin review
 +
# Go through the [http://spoken-tutorial.org/tutorial-search/?search_foss=LaTeX&search_language=English LaTeX spoken tutorial link] and learn '''LaTeX'''
 +
# Create '''sample slides''' and submit for Admin review to the Project Manager heading Creation
 +
# She will give you a feedback on the quality of your work
 +
# On approval from the Project Manager, proceed further
 +
 
----
 
----
  
Line 49: Line 66:
 
6. A brief list of usage  &nbsp; &nbsp; ''(where and how it can be used)''
 
6. A brief list of usage  &nbsp; &nbsp; ''(where and how it can be used)''
  
7. List of people-groups who will benefit &nbsp; &nbsp; ''(optional)''
+
7. List of people-groups who will benefit
  
8. Pre-requisite knowledge of any software &nbsp; &nbsp; ''(optional)''
+
8. Pre-requisite knowledge of any software
  
 
9. Name of the contributor(s) who wrote the outline and scripts and affiliation
 
9. Name of the contributor(s) who wrote the outline and scripts and affiliation
Line 58: Line 75:
  
 
<blockquote style="background-color: gainsboro; border: solid thin grey;">  
 
<blockquote style="background-color: gainsboro; border: solid thin grey;">  
  An '''Admin Verification''' will be done after this stage. ''' Here is what we will [http://spoken-tutorial.org/process/index.php/Admin_Checklist_Outline check'''].  
+
  An '''Admin Verification''' will be done after this stage. ''' Here is what we will [http://process.spoken-tutorial.org/index.php/Admin_Checklist_Outline check'''].  
 
</blockquote>
 
</blockquote>
 
----
 
----
Line 66: Line 83:
  
 
'''<u>Create Outline for the chosen FOSS</u>'''
 
'''<u>Create Outline for the chosen FOSS</u>'''
# Request the Project Manager heading Creation of Spoken Tutorials to share the Course Outline template with you
+
# Request the Project Manager heading Creation of Spoken Tutorials to share the '''Course Outline template''' with you
 
# Fill in the meta-data required for the FOSS series
 
# Fill in the meta-data required for the FOSS series
 
# List all the Topics for the FOSS series
 
# List all the Topics for the FOSS series
Line 87: Line 104:
  
 
<blockquote style="background-color: gainsboro; border: solid thin grey;">
 
<blockquote style="background-color: gainsboro; border: solid thin grey;">
'''A Domain Review will be done after this stage to ensure the pedagogy of the FOSS outline.''' &nbsp; &nbsp; '''Here is what we will [http://spoken-tutorial.org/process/index.php/Admin_Checklist_Outline check]'''.
+
'''A Domain Review will be done after this stage to ensure the pedagogy of the FOSS outline.''' &nbsp; &nbsp; '''Here is what we will [http://process.spoken-tutorial.org/index.php/Admin_Checklist_Outline check]'''.
 
<br>Once done, other contributors can be included for the next stages.
 
<br>Once done, other contributors can be included for the next stages.
 
</blockquote>
 
</blockquote>
  
 
<blockquote style="background-color: cornsilk; border: solid thin grey;">
 
<blockquote style="background-color: cornsilk; border: solid thin grey;">
'''Click here to view a [http://spoken-tutorial.org/process/index.php/FOSS_Outline_Template  sample outline page ]'''
+
'''Click here to view a [http://process.spoken-tutorial.org/index.php/FOSS_Outline_Template  sample outline page ]'''
 
</blockquote>
 
</blockquote>
 
----
 
----
Line 103: Line 120:
 
# The slides should be created using '''Beamer (LaTeX)'''  
 
# The slides should be created using '''Beamer (LaTeX)'''  
 
# Use minimum ''' 17pt''' on '''LaTeX Beamer''' slides.
 
# Use minimum ''' 17pt''' on '''LaTeX Beamer''' slides.
# '''All slides''' should have  
+
# All slides should have the [http://process.spoken-tutorial.org/index.php/File:St-logo.png Spoken Tutorial] logo  
## The [http://spoken-tutorial.org/process/images/9/93/ST_3T_Logo.pdf Talk to a Teacher] logo  
+
 
# The '''first slide''' should have   
 
# The '''first slide''' should have   
 
## The name of the Topic (tutorial)  
 
## The name of the Topic (tutorial)  
 
## The credits to the Mission, project, url-links, etc...
 
## The credits to the Mission, project, url-links, etc...
## Script-writer + institute affiliation and narrator + institute affiliation <br> [[Media:1-contributor.pdf | 1-contributor sample]] &nbsp;&nbsp;&nbsp; [[Media:2-contributor.pdf | 2-contributors sample]] &nbsp;&nbsp;&nbsp; [[Media:3-contributor.pdf | 3-contributors sample]]  &nbsp;&nbsp;&nbsp; [[Media:Group-contributor.pdf | Group contributor sample]]
+
## Script-writer + institute affiliation and narrator + institute affiliation <br> [[Media:Sample-1contributor.pdf | 1-contributor sample]] &nbsp;&nbsp;&nbsp; [[Media:Sample-2-contributor.pdf | 2-contributors sample]] &nbsp;&nbsp;&nbsp; [[Media:Sample-3-contributor.pdf | 3-contributors sample]]  &nbsp;&nbsp;&nbsp; [[Media:Sample-group-contributor.pdf | Group contributor sample]]
 
## The date of creation
 
## The date of creation
 
# The '''second slide''' should clearly mention
 
# The '''second slide''' should clearly mention
## The Learning Objectives &nbsp;&nbsp;&nbsp; [[Media:Learning-Objectives.pdf | Learning objectives sample]]
+
## The '''Learning Objectives''' &nbsp;&nbsp;&nbsp; [[Media:Sample-Learning-Objectives.pdf | Learning objectives sample]]
 
# The '''third slide''' should clearly mention
 
# The '''third slide''' should clearly mention
 
## The software version number
 
## The software version number
## The operating system used &nbsp;&nbsp;&nbsp; [[Media:OS-versions.pdf | OS-version sample]]
+
## The operating system used
# The '''fourth slide''' should clearly mention Pre-requisites, if any, as follows
+
## Any editor that was used
## Knowledge of some software like C, vi, Linux, Emacs, PHP, Java
+
## Any browser that was used &nbsp;&nbsp;&nbsp; [[Media:Sample-system-requirements.pdf | System Requirements sample]]
 +
# The '''fourth slide''' should clearly mention '''Pre-requisites''', if any, as follows
 +
## Knowledge of some software like Java, some subject like High School Mathematics, etc.
 
## Reference to a spoken tutorial in this series or another software series
 
## Reference to a spoken tutorial in this series or another software series
## All of the above    &nbsp;&nbsp;&nbsp; [[Media:OS-versions.pdf  | OS-version sample]]
+
## All of the above    &nbsp;&nbsp;&nbsp; [[Media:OS-versions.pdf  | Pre-requisites sample]]
 +
# The '''fifth slide''' should clearly mention
 +
## '''Code Files''', if any  &nbsp;&nbsp;&nbsp; [[Media:Code-Files.pdf | Code Files sample]]
 
# The '''last slides''' should have text as shown in these samples -
 
# The '''last slides''' should have text as shown in these samples -
## [[Media:Ack-Indi.pdf | Acknowledgment for Individual contributor]]
+
## [[Media:Sample-Ind-slides.pdf | Acknowledgment for Individual contributor]]
## [[Media:Ack-Org.pdf | Acknowledgment for Group Contributors]]  
+
## [[Media:Sample-Org-slides.pdf| Acknowledgment for Group Contributors]]  
  
 
<span style="color:red">'''Here the Slide Template stage is complete.''' </span>
 
<span style="color:red">'''Here the Slide Template stage is complete.''' </span>
  
 
<blockquote style="background-color: gainsboro; border: solid thin grey;">
 
<blockquote style="background-color: gainsboro; border: solid thin grey;">
'''Submit the slide template''' to the Project Manager heading Creation of Spoken Tutorials '''for review''' at <span style="color:blue">administrator@spoken-tutorial.org. </span> &nbsp; &nbsp; '''Here is what we will [http://spoken-tutorial.org/process/index.php/Admin_Checklist_Slide_template check].'''
+
'''Submit the slide template''' to the Project Manager heading Creation of Spoken Tutorials '''for review''' at <span style="color:blue">administrator@spoken-tutorial.org. </span> &nbsp; &nbsp; '''Here is what we will [http://process.spoken-tutorial.org/index.php/Admin_Checklist_Slide_template check].'''
 
</blockquote>
 
</blockquote>
  
Line 132: Line 152:
  
 
<blockquote style="background-color: cornsilk; border: solid thin grey;">
 
<blockquote style="background-color: cornsilk; border: solid thin grey;">
'''Click here to view the '''Acknowledgement script'''  [http://spoken-tutorial.org/process/index.php/Acknowledgement Script-Format]''' <br>
+
'''Click here to view the '''Acknowledgement script'''  [http://process.spoken-tutorial.org/index.php/Acknowledgement Script-Format]''' <br>
'''Click here to view the '''Title and Acknowledgement tex file'''  [[Media:Acknowledgement-TEX.tex | TEX-Format]]'''
+
 
</blockquote>
 
</blockquote>
 
----
 
----
Line 141: Line 160:
 
# We recommend that you use '''LibreOffice Writer''' to type your script
 
# We recommend that you use '''LibreOffice Writer''' to type your script
 
# In '''LibreOffice Writer''', the script should be typed in '''wiki-markup''' so that you can directly copy and paste it later   
 
# In '''LibreOffice Writer''', the script should be typed in '''wiki-markup''' so that you can directly copy and paste it later   
# To see a '''sample wiki-markup script''', please visit [http://www.spoken-tutorial.org/script/index.php/English-Timed-script English-Timed-script] and do the following -  
+
# To see a '''sample wiki-markup script''', please visit [http://script.spoken-tutorial.org/index.php/English-script English-script] and do the following -  
 
## Login to '''script-wiki''', since you have an account there
 
## Login to '''script-wiki''', since you have an account there
 
## Click on the '''edit''' tab
 
## Click on the '''edit''' tab
## Now copy and paste the wiki-markup to your document in '''LibreOffice Writer'''
+
## Now copy and paste the '''wiki-markup script''' to your document in '''LibreOffice Writer'''
 +
## Type out your script exactly like the sample using the pipes '''"|-"''', '''"|"''' and''' "||"''' as shown
 +
## Save this script for uploading later
  
 
=====Script-Writing Instructions=====
 
=====Script-Writing Instructions=====
 
# Take up one Topic from the Basic Level (similar for Intermediate and Advanced levels)
 
# Take up one Topic from the Basic Level (similar for Intermediate and Advanced levels)
# Read the Guidelines for writing a script &nbsp; &nbsp; [http://spoken-tutorial.org/process/index.php/How_to_write_a_Script_for_Spoken_Tutorials_Summary Summary]  &nbsp; &nbsp;  '''and''' &nbsp; &nbsp; [http://spoken-tutorial.org/process/index.php/How_to_write_a_Script_for_Spoken_Tutorials Details]
+
# Read the Guidelines for writing a script &nbsp; &nbsp; [http://process.spoken-tutorial.org/index.php/How_to_write_a_Script_for_Spoken_Tutorials_Summary Summary]  &nbsp; &nbsp;  '''and''' &nbsp; &nbsp; [http://process.spoken-tutorial.org/index.php/How_to_write_a_Script_for_Spoken_Tutorials Details]
# A [http://spoken-tutorial.org/process/index.php/Xfig/simple-diagram-languages/English Sample 2-column script] is available here
+
# A [https://script.spoken-tutorial.org/index.php/HTML/C2/Phrase-Tags-in-HTML/English Sample 2-column script] is available here
 
# A good script has a lot of '''demonstrations (75%)''' interspersed with '''slides of text (25%)''' elaborating various features
 
# A good script has a lot of '''demonstrations (75%)''' interspersed with '''slides of text (25%)''' elaborating various features
 
# Write the script for the chosen topic in the 2-column format as explained above  
 
# Write the script for the chosen topic in the 2-column format as explained above  
# Every script should end with the text given in the [http://spoken-tutorial.org/process/index.php/Acknowledgement Acknowledgement] link.  (Refer to '''Stage 2 point 11''')
+
# Every script should end with the text given in the [http://process.spoken-tutorial.org/index.php/Acknowledgement Acknowledgement] link.  (Refer to '''Stage 2 point 11''')
 
# Prepare the corresponding slides for the script.  
 
# Prepare the corresponding slides for the script.  
 
##  Use the slide template created in '''Stage 2'''
 
##  Use the slide template created in '''Stage 2'''
Line 160: Line 181:
 
##  See to it that the text on the slides correspond to the script wherever it is used
 
##  See to it that the text on the slides correspond to the script wherever it is used
 
##  Please use at least '''17pt font-size''' for the text
 
##  Please use at least '''17pt font-size''' for the text
# Review it against the [http://spoken-tutorial.org/process/index.php/Creators_Checklist Script Checklist] and make the required modifications
+
# While creating the code files in the Text Editors, use at least font size 24-monospace
# Get it validated by a novice using the [http://spoken-tutorial.org/process/index.php/USER_FEEDBACK_FORMS User-feedback Checklist] and if required make the modifications <br>(You may approach the Spoken Tutorial Team for help in finding a novice at administrator@spoken-tutorial.org)  
+
# Review it against the [http://process.spoken-tutorial.org/index.php/Creators_Checklist Script Checklist] and make the required modifications
 +
# Get all the components validated by a novice using the [http://process.spoken-tutorial.org/index.php/USER_FEEDBACK_FORMS User-feedback Checklist] and if required make the modifications <br>(You may approach the Spoken Tutorial Team for help in finding a novice at administrator@spoken-tutorial.org)
 +
 
 +
=====Uploading Instructions=====
 
# Once you have revised your script and corresponding files, upload the same on the website.  To do so,  
 
# Once you have revised your script and corresponding files, upload the same on the website.  To do so,  
 +
## Convert the script file to wiki-markup-language format by following the instructions given in this link - [[How_to_use_OpenOffice_script_template#Installing_openoffice.org-wiki-publisher_-_An_Alternate_way]]
 +
## Export the content to Wiki as instructed in this link -  [[How_to_use_OpenOffice_script_template#Export_content_to_wiki_from_Openoffice.2FLibreOffice]]
 
## Zip the tex file, the pdf file, the logos used
 
## Zip the tex file, the pdf file, the logos used
 
## Zip all the code/tech files used  
 
## Zip all the code/tech files used  
 
## Zip all the assignment files
 
## Zip all the assignment files
 
## Login to the website
 
## Login to the website
## In the '''Upload Interface''' panel, click on '''Upload English Tutorial'''
+
## On the '''Home Page''', click on '''Creation''' tab and select '''Creation Dashboard''' in the drop-down
## Select the '''FOSS Category Name, Tutorial Level''' and '''Tutorial Name''' from the drop-down lists  
+
## Locate the '''Contributor''' panel
## On the next webpage, first of all upload the '''Tutorial Outline'''.  This should be taken from the Course Outline for that FOSS
+
## Click on '''Upload/Update tutorials''' link
## Then upload the '''script, slides zip file, code zip files''' and '''assignment file(s)'''
+
## Select the '''FOSS Category, Language''' and '''Tutorial Name''' from the drop-down lists  
## If you don't have code files for that particular tutorial, then select '''"Not required"''' status
+
## In the first part of the page, the meta-data of the selected topic will be displayed
# Please note there are '''5 uploads''' at this point
+
## In the second half, which is highlighted in pink colour, you will see all the 8 components listed
 +
## There will be 1 icon, namely, the '''Upload''' icon, visible to the extreme right of each component
 +
## For some components, 2 icons will be visible, namely, '''Upload''' and '''"Not Required" status'''
 +
## First of all upload the '''Outline'''.  This should be taken from the Course Outline for that FOSS
 +
## Then upload the '''Script, Slides zip file, Code zip files, Assignment file(s), Pre-requisite''' and '''Keywords'''.  The script is the same one you created using the '''General Instructions''' given above
 +
## If you don't have '''Code files''' or '''Assignment''' or '''Prerequisite''' for that particular tutorial, then select '''"Not Required" status'''
 +
# Please note there are '''7 uploads''' at this point
 +
 
 +
=====Review Instructions=====
 
# The Project Manager will get an expert-review and an admin check done
 
# The Project Manager will get an expert-review and an admin check done
 
# Remarks will be posted on the '''Upload Interface''' itself
 
# Remarks will be posted on the '''Upload Interface''' itself
Line 180: Line 214:
  
 
<blockquote style="background-color: gainsboro; border: solid thin grey;">
 
<blockquote style="background-color: gainsboro; border: solid thin grey;">
'''Submit the script''' to the Spoken Tutorial team '''for review''' at <span style="color:blue">administrator@spoken-tutorial.org. </span> &nbsp; &nbsp; ''' Here is what we will [http://spoken-tutorial.org/process/index.php/Admin_Checklist_Script check]'''
+
'''Submit the script''' to the Spoken Tutorial team '''for review''' at <span style="color:blue">administrator@spoken-tutorial.org. </span> &nbsp; &nbsp; ''' Here is what we will [http://process.spoken-tutorial.org/index.php/Admin_Checklist_Script check]'''
 
</blockquote>
 
</blockquote>
  
 
<blockquote style="background-color: cornsilk; border: solid thin grey;">
 
<blockquote style="background-color: cornsilk; border: solid thin grey;">
 
'''P.S.''' Additonal information
 
'''P.S.''' Additonal information
: You may want to read more on [http://spoken-tutorial.org/process/index.php/Pedagogy Pedagogy] and different [http://spoken-tutorial.org/process/index.php/Appendix pedagogical approaches]
+
: You may want to read more on [http://process.spoken-tutorial.org/index.php/Pedagogy Pedagogy] and different [http://process.spoken-tutorial.org/index.php/Appendix pedagogical approaches]
 
</blockquote>
 
</blockquote>
 
----
 
----
  
 
===Stage 4: <u>Tutorial</u>===
 
===Stage 4: <u>Tutorial</u>===
# Read the [http://spoken-tutorial.org/process/index.php/Guidelines_for_narrating_a_Spoken_Tutorial Guidelines for narrating a spoken tutorial]
+
=====Recording Instructions=====
# Read the [http://spoken-tutorial.org/process/index.php/Guidelines_for_Screencasting_a_Spoken_Tutorial Guidelines for screencasting a spoken tutorial]
+
# Read the [http://process.spoken-tutorial.org/index.php/Guidelines_for_narrating_a_Spoken_Tutorial Guidelines for narrating a spoken tutorial]
 +
# Read the [http://process.spoken-tutorial.org/index.php/Guidelines_for_Screencasting_a_Spoken_Tutorial Guidelines for screencasting a spoken tutorial]
 
# Create a tutorial based on the "reviewed" script
 
# Create a tutorial based on the "reviewed" script
 
# Please see that the recording dimensions are '''not lesser than 800x600 pixels'''  
 
# Please see that the recording dimensions are '''not lesser than 800x600 pixels'''  
Line 206: Line 241:
 
## In the General Tab, '''uncheck''' the box for ''Use the system fixed width font''
 
## In the General Tab, '''uncheck''' the box for ''Use the system fixed width font''
 
## Now click on the default Font and change the font-size to 20 or above
 
## Now click on the default Font and change the font-size to 20 or above
# Review it against the [http://spoken-tutorial.org/process/index.php/Creators_Checklist Tutorial Checklist] and make the required modifications
+
# In the Text Editors, use at least font size 24-monospace
# Once you have revised your video, upload the same on the websiteTo do so,  
+
# You may choose to enlarge the cursor, too, to improve visibility
## Login to the website
+
# Highlight the text on the slides or the terminal, using the cursor, whenever required
## In the Upload Interface panel, click on '''Update Existing Tutorial'''
+
# Review it against the [http://process.spoken-tutorial.org/index.php/Creators_Checklist Tutorial Checklist] and make the required modifications
## Select the FOSS Category Name and Language from the drop-down lists  
+
 
## On the next webpage, upload the video
+
=====Uploading Instructions=====
# Spoken Tutorial Team will get an expert-review and an admin check done
+
# Once you have revised your video, upload the same on the website
 +
# To do so, login to the website
 +
# On the '''Home Page''', click on '''Creation''' tab and select '''Creation Dashboard''' in the drop-down
 +
# Locate the '''Contributor''' panel
 +
# Click on '''Upload/Update tutorials''' link
 +
# Select the '''FOSS Category, Language''' and '''Tutorial Name''' from the drop-down lists  
 +
# In the first part of the page, the meta-data of the selected topic will be displayed
 +
# In the second half, the '''Video''' component will be seen highlighted in pink colour
 +
# Click on the '''Upload''' icon, visible to the extreme right of '''Video''' component
 +
# In the dialog box that opens, browse and upload your video
 +
# For '''Video Thumbnail time''', choose the '''Minute''' and '''Second''' of the portion from the video, that you would like to appear in the thumbnail
 +
#:<br>
 +
# The first time you upload
 +
## Click on '''Upload''' button
 +
## Close the dialog box
 +
## You will come back to the previous page
 +
#:<br>
 +
# The second and subsequent times you upload
 +
## You will see '''What to do with old video?''' message
 +
## In drop-down, you will see three options-
 +
### Choose '''Replace old video''' if you are doing corrections to the same video you uploaded previously
 +
### Choose '''Archive old video as Correction''' if you are replacing the old video due to some major Correction that was pointed out in the old video
 +
### Choose '''Archive old video as Verison''' if you are replacing the old video due to Version change in the software
 +
## Click on '''Upload''' button
 +
## Close the dialog box
 +
## You will come back to the previous page
 +
#:<br>
 +
# Intimate the '''IITB Project Manger''' on completion of this stage or write to ['''administrator@spoken-tutorial.org'''].  Here is what we will [http://process.spoken-tutorial.org/index.php/Admin_Checklist_Dubbing  check]
 +
#: <br>
 +
#: Again, we are available to assist you at every step.
 +
 
 +
=====Review Instructions=====
 +
# The Project Manager will get an expert-review and an admin check done
 
# Remarks will be posted on the Upload Interface itself
 
# Remarks will be posted on the Upload Interface itself
 
# If changes are to be made post expert-review, pls do them and submit again.
 
# If changes are to be made post expert-review, pls do them and submit again.
Line 219: Line 286:
  
 
<blockquote style="background-color: gainsboro; border: solid thin grey;">
 
<blockquote style="background-color: gainsboro; border: solid thin grey;">
'''Submit the tutorial''' to the Spoken Tutorial team '''for review''' at <span style="color:blue">administrator@spoken-tutorial.org. </span> &nbsp; &nbsp; ''' Here is what we will [http://spoken-tutorial.org/process/index.php/Admin_Checklist_Spoken_Tutorial check].'''
+
'''Submit the tutorial''' to the Spoken Tutorial team '''for review''' at <span style="color:blue">administrator@spoken-tutorial.org. </span> &nbsp; &nbsp; ''' Here is what we will [http://process.spoken-tutorial.org/index.php/Admin_Checklist_Spoken_Tutorial check].'''
 
</blockquote>
 
</blockquote>
  

Latest revision as of 15:58, 13 December 2019

Stages in the life-cycle of Spoken Tutorials

Click here to see the Guidelines Checklist

Before Creation: Checklist Test

1. Please go through the Checklist criteria given in the link above and understand them thoroughly.

2. You will need to take an online test based on the Checklist before you begin contributing content. So, learn the criteria and their reasons thoroughly.

3. Once you are ready, write to the Project Manager heading Creation of Spoken Tutorials at administrator@spoken-tutorial.org.

4. She will tell you the procedure to take this test.

5. You have to clear this test with 80%. After clearing the test, you can proceed to the next stage.

6. If you do not clear the test, then you will have to re-attempt the same after 15 days.


Click here for guidance on Self-Learning-Materials available on wikieducator.org


After Checklist Test: Creating accounts

  1. Create an account for yourself on http://spoken-tutorial.org
  2. You will receive a mail with an authentication link
  3. Click on that link and complete the required verification
  4. Login to the website using your username and password
  5. Click on Creation tab and select Creation Dashboard from the drop-down
  6. Click on "Add me as contributor" link
  7. Initimate the Project Manager - Creation, that you have done so
  8. Share your username with her so that she can authenticate your role as contributor
  9. Once done, we will create an account for you on http://script.spoken-tutorial.org and share the details with you

For any assistance, please contact us.


Learning activity

  1. Go through the screencasting videos and learn how to create a screencast video using either one -
  2. Create a sample 2 min video and submit for Admin review
  3. Go through the LaTeX spoken tutorial link and learn LaTeX
  4. Create sample slides and submit for Admin review to the Project Manager heading Creation
  5. She will give you a feedback on the quality of your work
  6. On approval from the Project Manager, proceed further

Stage 0: Introduction text on the FOSS page

This is a one-time creation process for a FOSS

1. Identify the FOSS (name of the FOSS)

2. Mention the version number of the FOSS

3. Mention the OS used

4. At this point, please add this sentence

Please see the associated text box of individual spoken tutorials on the website to decide the versions of software and OS to which it is applicable.

5. A brief description about the FOSS

6. A brief list of usage     (where and how it can be used)

7. List of people-groups who will benefit

8. Pre-requisite knowledge of any software

9. Name of the contributor(s) who wrote the outline and scripts and affiliation

Here the Introduction stage is complete.

An Admin Verification will be done after this stage. Here is what we will check.


Stage 1: Outline and Topics

This is a one-time creation process for a FOSS

Create Outline for the chosen FOSS

  1. Request the Project Manager heading Creation of Spoken Tutorials to share the Course Outline template with you
  2. Fill in the meta-data required for the FOSS series
  3. List all the Topics for the FOSS series
  4. Chunk the Topics into 2/3 levels
    • Basic - Intermediate - Advanced or
    • Basic - Advanced

Topics

  1. Take up Basic Level first
  2. List out the content to be covered in each topic in bullet points
  3. Do the same for the Intermediate and Advanced levels (at a convenient time)
  4. Submit the outline for review (Admin and Domain reviews)
  5. Improvise the Outline based on the comments and suggestion given by the concerned Domain reviewer and the Project Manager heading Creation
  6. Once frozen, this outline should be uploaded on the Outline wiki page. The details for this will be provided by the Project Manager heading Creation

Here the Outline stage is complete.

Glossary

  1. Create a link named Glossary on the outline page.
  2. When clicked, it should lead to a page on which each contributor to this FOSS will enter the technical terms used in the scripts with the definitions for those terms. These could be domain-specific terminology, abbreviations, acronyms, etc... Ideally, this should be an alphabetical list.

A Domain Review will be done after this stage to ensure the pedagogy of the FOSS outline.     Here is what we will check.
Once done, other contributors can be included for the next stages.

Click here to view a sample outline page


Stage 2: Create a template for the slides

Creation of template is a one-time process

  1. Pls use the same slide template design/colour for all the tutorials for this FOSS.
  2. This helps improve the aesthetic look of the tutorials by its uniformity.
  3. They will look like they belong to the same FOSS domain.
  4. The slides should be created using Beamer (LaTeX)
  5. Use minimum 17pt on LaTeX Beamer slides.
  6. All slides should have the Spoken Tutorial logo
  7. The first slide should have
    1. The name of the Topic (tutorial)
    2. The credits to the Mission, project, url-links, etc...
    3. Script-writer + institute affiliation and narrator + institute affiliation
      1-contributor sample     2-contributors sample     3-contributors sample     Group contributor sample
    4. The date of creation
  8. The second slide should clearly mention
    1. The Learning Objectives     Learning objectives sample
  9. The third slide should clearly mention
    1. The software version number
    2. The operating system used
    3. Any editor that was used
    4. Any browser that was used     System Requirements sample
  10. The fourth slide should clearly mention Pre-requisites, if any, as follows
    1. Knowledge of some software like Java, some subject like High School Mathematics, etc.
    2. Reference to a spoken tutorial in this series or another software series
    3. All of the above     Pre-requisites sample
  11. The fifth slide should clearly mention
    1. Code Files, if any     Code Files sample
  12. The last slides should have text as shown in these samples -
    1. Acknowledgment for Individual contributor
    2. Acknowledgment for Group Contributors

Here the Slide Template stage is complete.

Submit the slide template to the Project Manager heading Creation of Spoken Tutorials for review at administrator@spoken-tutorial.org.     Here is what we will check.

Once you get the approval for the template, zip all the files used for creating the template, upload and link it on the Outline page.
Other contributors can download this folder and use the same slide template.

Click here to view the Acknowledgement script Script-Format


Stage 3: Script

General Instructions
  1. We recommend that you use LibreOffice Writer to type your script
  2. In LibreOffice Writer, the script should be typed in wiki-markup so that you can directly copy and paste it later
  3. To see a sample wiki-markup script, please visit English-script and do the following -
    1. Login to script-wiki, since you have an account there
    2. Click on the edit tab
    3. Now copy and paste the wiki-markup script to your document in LibreOffice Writer
    4. Type out your script exactly like the sample using the pipes "|-", "|" and "||" as shown
    5. Save this script for uploading later
Script-Writing Instructions
  1. Take up one Topic from the Basic Level (similar for Intermediate and Advanced levels)
  2. Read the Guidelines for writing a script     Summary     and     Details
  3. A Sample 2-column script is available here
  4. A good script has a lot of demonstrations (75%) interspersed with slides of text (25%) elaborating various features
  5. Write the script for the chosen topic in the 2-column format as explained above
  6. Every script should end with the text given in the Acknowledgement link. (Refer to Stage 2 point 11)
  7. Prepare the corresponding slides for the script.
    1. Use the slide template created in Stage 2
    2. You are required to create slides whenever there is a long narration without any corresponding activity on the screen
    3. The purpose of using Slides is to keep the viewer engaged
    4. The text on the slides should be in bullet points. The text should be precise and to the point
    5. See to it that the text on the slides correspond to the script wherever it is used
    6. Please use at least 17pt font-size for the text
  8. While creating the code files in the Text Editors, use at least font size 24-monospace
  9. Review it against the Script Checklist and make the required modifications
  10. Get all the components validated by a novice using the User-feedback Checklist and if required make the modifications
    (You may approach the Spoken Tutorial Team for help in finding a novice at administrator@spoken-tutorial.org)
Uploading Instructions
  1. Once you have revised your script and corresponding files, upload the same on the website. To do so,
    1. Convert the script file to wiki-markup-language format by following the instructions given in this link - How_to_use_OpenOffice_script_template#Installing_openoffice.org-wiki-publisher_-_An_Alternate_way
    2. Export the content to Wiki as instructed in this link - How_to_use_OpenOffice_script_template#Export_content_to_wiki_from_Openoffice.2FLibreOffice
    3. Zip the tex file, the pdf file, the logos used
    4. Zip all the code/tech files used
    5. Zip all the assignment files
    6. Login to the website
    7. On the Home Page, click on Creation tab and select Creation Dashboard in the drop-down
    8. Locate the Contributor panel
    9. Click on Upload/Update tutorials link
    10. Select the FOSS Category, Language and Tutorial Name from the drop-down lists
    11. In the first part of the page, the meta-data of the selected topic will be displayed
    12. In the second half, which is highlighted in pink colour, you will see all the 8 components listed
    13. There will be 1 icon, namely, the Upload icon, visible to the extreme right of each component
    14. For some components, 2 icons will be visible, namely, Upload and "Not Required" status
    15. First of all upload the Outline. This should be taken from the Course Outline for that FOSS
    16. Then upload the Script, Slides zip file, Code zip files, Assignment file(s), Pre-requisite and Keywords. The script is the same one you created using the General Instructions given above
    17. If you don't have Code files or Assignment or Prerequisite for that particular tutorial, then select "Not Required" status
  2. Please note there are 7 uploads at this point
Review Instructions
  1. The Project Manager will get an expert-review and an admin check done
  2. Remarks will be posted on the Upload Interface itself
  3. If changes are to be made post expert-review or admin check, pls make the required modifications and upload again

Here the Script stage is complete.

Submit the script to the Spoken Tutorial team for review at administrator@spoken-tutorial.org.     Here is what we will check

P.S. Additonal information

You may want to read more on Pedagogy and different pedagogical approaches

Stage 4: Tutorial

Recording Instructions
  1. Read the Guidelines for narrating a spoken tutorial
  2. Read the Guidelines for screencasting a spoken tutorial
  3. Create a tutorial based on the "reviewed" script
  4. Please see that the recording dimensions are not lesser than 800x600 pixels
  5. Please also keep the aspect ratio at 4:3 only
  6. On the web-browser, please enlarge the address bar fonts.
    1. There is this add-on in Firefox which enlarges the address bar font for any web-page.
    2. Available on this link - https://addons.mozilla.org/en-US/firefox/addon/make-address-bar-font-size-big/
    3. First go to the above links and click on ADD TO FIREFOX.
    4. Open Firefox >> Click on Tools >> Add-ons >> Install.
    5. When not required, click on DISABLE else ENABLE.
  7. On the Linux terminal, for the commands, please use font-size 20 or above. To do so,
    1. Open the Linux terminal window
    2. Click on Edit >> Profile Preferences
    3. In the General Tab, uncheck the box for Use the system fixed width font
    4. Now click on the default Font and change the font-size to 20 or above
  8. In the Text Editors, use at least font size 24-monospace
  9. You may choose to enlarge the cursor, too, to improve visibility
  10. Highlight the text on the slides or the terminal, using the cursor, whenever required
  11. Review it against the Tutorial Checklist and make the required modifications
Uploading Instructions
  1. Once you have revised your video, upload the same on the website
  2. To do so, login to the website
  3. On the Home Page, click on Creation tab and select Creation Dashboard in the drop-down
  4. Locate the Contributor panel
  5. Click on Upload/Update tutorials link
  6. Select the FOSS Category, Language and Tutorial Name from the drop-down lists
  7. In the first part of the page, the meta-data of the selected topic will be displayed
  8. In the second half, the Video component will be seen highlighted in pink colour
  9. Click on the Upload icon, visible to the extreme right of Video component
  10. In the dialog box that opens, browse and upload your video
  11. For Video Thumbnail time, choose the Minute and Second of the portion from the video, that you would like to appear in the thumbnail

  12. The first time you upload
    1. Click on Upload button
    2. Close the dialog box
    3. You will come back to the previous page

  13. The second and subsequent times you upload
    1. You will see What to do with old video? message
    2. In drop-down, you will see three options-
      1. Choose Replace old video if you are doing corrections to the same video you uploaded previously
      2. Choose Archive old video as Correction if you are replacing the old video due to some major Correction that was pointed out in the old video
      3. Choose Archive old video as Verison if you are replacing the old video due to Version change in the software
    3. Click on Upload button
    4. Close the dialog box
    5. You will come back to the previous page

  14. Intimate the IITB Project Manger on completion of this stage or write to [administrator@spoken-tutorial.org]. Here is what we will check

    Again, we are available to assist you at every step.
Review Instructions
  1. The Project Manager will get an expert-review and an admin check done
  2. Remarks will be posted on the Upload Interface itself
  3. If changes are to be made post expert-review, pls do them and submit again.

Here the Tutorial stage is complete.

Submit the tutorial to the Spoken Tutorial team for review at administrator@spoken-tutorial.org.     Here is what we will check.

You may at this stage delegate the work among other contributors who desire to participate in this FOSS. Here onwards, you will moderate and review all the work submitted for this FOSS and help fellow-contributors. We are available throughout for any assistance.


You have created your benchmark at this stage. You are now "qualified" to write scripts and create tutorials. All future work in this FOSS will use the above as reference. And for your effort, you will receive an honorarium.

Contributors and Content Editors

Gyan, Nancy varkey, St-admin