[LON-CAPA-cvs] cvs: loncom /html/adm/help/tex Portfolio_About.tex Portfolio_AddFiles.tex Portfolio_Catalog.tex Portfolio_ChangeDirectory.tex Portfolio_CreateDirectory.tex Portfolio_DeleteFile.tex Portfolio_FileList.tex Portfolio_OpenFile.tex Portfolio_RenameFile.tex Portfolio_ShareFile.tex Portfolio_ShareFile_ChangeSetting.tex Portfolio_ShareFile_SetAccess.tex Portfolio_ShareFile_StopAccess.tex
rezaferry
lon-capa-cvs@mail.lon-capa.org
Tue, 28 Nov 2006 02:35:56 -0000
This is a MIME encoded message
--rezaferry1164681356
Content-Type: text/plain
rezaferry Mon Nov 27 21:35:56 2006 EDT
Modified files:
/loncom/html/adm/help/tex Portfolio_About.tex
Portfolio_AddFiles.tex
Portfolio_Catalog.tex
Portfolio_ChangeDirectory.tex
Portfolio_CreateDirectory.tex
Portfolio_DeleteFile.tex
Portfolio_FileList.tex
Portfolio_OpenFile.tex
Portfolio_RenameFile.tex
Portfolio_ShareFile.tex
Portfolio_ShareFile_ChangeSetting.tex
Portfolio_ShareFile_SetAccess.tex
Portfolio_ShareFile_StopAccess.tex
Log:
Fixes for the portfolio documentation. Changes made according to Mark's suggestions
--rezaferry1164681356
Content-Type: text/plain
Content-Disposition: attachment; filename="rezaferry-20061127213556.txt"
Index: loncom/html/adm/help/tex/Portfolio_About.tex
diff -u loncom/html/adm/help/tex/Portfolio_About.tex:1.3 loncom/html/adm/help/tex/Portfolio_About.tex:1.4
--- loncom/html/adm/help/tex/Portfolio_About.tex:1.3 Sun Nov 5 20:52:00 2006
+++ loncom/html/adm/help/tex/Portfolio_About.tex Mon Nov 27 21:35:53 2006
@@ -1,16 +1,16 @@
\label{Portfolio_About}
-The portfolio \index{portfolio} allows you to store and retrieve files. There are two main purpose of using a portfolio; to upload documents that could then be submitted in response to an essay/drop box/task and to upload documents that can be shared. By storing in the portfolio space of lon-capa you can access these files from any location with an internet/web connection.
+The portfolio \index{portfolio} allows you to store and retrieve files on the LON-CAPA server. There are two main purpose of using a portfolio; to upload documents that could then be submitted in response to an essay/drop box/task and to upload documents. Files stored in your portfolio can only be acessed by you, unless you publish them for other users to view (See: Sharing File \ref{Portfolio_ShareFile}). By storingfiles in the portfolio space of LON-CAPA you can access these files from any computer with an internet/web connection.
-Every student user on the LON-CAPA system has a quota of 20 MB of portfolio space. Each file the student add reduces the quota. However, portfolio submitted files can be modified by the grader and then uploaded back to the student, this will apear as a new 'version' of the file for the student but does not count against their quota.
+Every user on the LON-CAPA system has a quota of 20 MB of portfolio space. Each file you add reduces your quota. However, portfolio submitted files can be modified by the grader and then uploaded back to the student, this will apear as a new 'version' of the file for the student but does not count against their quota.
There is also a group portfolio with a quota that is set by the group creator (typically a course coordinator). Group portfolios have the same functionalities as student portfolio. The main difference being that a number of people have access to group portfolios. It may be the case that some group members have different access to other group members. Once again, this is controlled by the group creator.
-To use the portfolio to store files you must first create directories (See: Creating Directory \ref{Portfolio_CreateDirectory}) and subdirectories. After creating the directory that you need to enter the directory (See: Changing Directory \ref{Portfolio_ChangeDirectory}) and upload the file (See: Adding Files \ref{Portfolio_AddFiles}) to the current directory.
+Your portfolio work much like file storage on your computer. You may create directories and subdirectories to organize your files(See: Creating Directory \ref{Portfolio_CreateDirectory}). After creating a directory, you must enter the directory (See: Changing Directory \ref{Portfolio_ChangeDirectory}) and upload your file (See: Adding Files \ref{Portfolio_AddFiles}) to the current directory.
-To use the portfolio to retrieve file, find the directory that contains the file then click on the file name (See: Opening File \ref{Portfolio_OpenFile}). The file that you wanted will be downloaded to your computer.
+To retrieve a file, find the directory that contains the file then click on the file name (See: Opening File \ref{Portfolio_OpenFile}). The file will be downloaded to your computer.
-You can also share your files by changing the file permissions (See: Sharing File \ref{Portfolio_ShareFile}). You can also find/read other people's shared files by typing going to the other person's about me page (http://server/adm/domain/user/aboutme/portfolio).
+You may share your files by changing the file permissions. You can also find/read other people's shared files by going to the other person's about me page.
Also see:
\textbf{Deleting File} (\ref{Portfolio_DeleteFile}), \textbf{Renaming File} (\ref{Portfolio_RenameFile}), \textbf{File Catalogs} (\ref{Portfolio_Catalog}) and \textbf{The file list} (\ref{Portfolio_FileList}).
Index: loncom/html/adm/help/tex/Portfolio_AddFiles.tex
diff -u loncom/html/adm/help/tex/Portfolio_AddFiles.tex:1.2 loncom/html/adm/help/tex/Portfolio_AddFiles.tex:1.3
--- loncom/html/adm/help/tex/Portfolio_AddFiles.tex:1.2 Thu Nov 2 23:10:15 2006
+++ loncom/html/adm/help/tex/Portfolio_AddFiles.tex Mon Nov 27 21:35:53 2006
@@ -1,11 +1,11 @@
\label{Portfolio_AddFiles}
-To add files first make sure that you are in the correct directory (See: Creating Directory \ref{Portfolio_CreateDirectory}, Changing Directory \ref{Portfolio_ChangeDirectory}). The current directory you are in is shown above the list of files. The current directory indicator starts with the text portfolio and is a link. Click on the directory name that you want to enter the directory.
+To add files first make sure that you are in the correct directory (See: Creating Directory \ref{Portfolio_CreateDirectory}, Changing Directory \ref{Portfolio_ChangeDirectory}). The current directory you are in is shown above the list of files. The current directory indicator is a link starting with the text "portfolio".
-Once you are in the correct directory upload the file that you want by:
+Once you are in the correct directory :
\begin{enumerate}
-\item Click on \fbox{browse} to find the file from your local filesystem that you wish to upload to the portfolio space. You can only upload files, you cannot upload whole folders.
-\item Press \fbox{upload}.
-\item When the file is uploaded (it may take a while if the file is large) a screen will show up that says done. Click on that link and you will be taken back to the portfolio screen.
+\item Press on \textbf{Browse} to find the file from your local filesystem that you wish to upload to the portfolio space. You can only upload files, you cannot upload whole folders.
+\item Press \textbf{Upload}.
+\item When the file is uploaded (it may take a while if the file is large) a screen will confirm that the upload has succeeded. A link is available to take you back to the portfolio screen.
\end{enumerate}
Index: loncom/html/adm/help/tex/Portfolio_Catalog.tex
diff -u loncom/html/adm/help/tex/Portfolio_Catalog.tex:1.1 loncom/html/adm/help/tex/Portfolio_Catalog.tex:1.2
--- loncom/html/adm/help/tex/Portfolio_Catalog.tex:1.1 Sun Nov 5 20:52:00 2006
+++ loncom/html/adm/help/tex/Portfolio_Catalog.tex Mon Nov 27 21:35:53 2006
@@ -1,8 +1,8 @@
\label{Portfolio_Catalog}
-The catalog information allows you to enter additional information about the document being uploaded. The information can be used to categorize the document, and it can also be used for search.
+The catalog information allows you to enter additional information about a document that has been uploaded. The information can be used to categorize the document to be used for searching.
-To create or edit catalog information, press the \fbox{Cat} button next to the rename link in the file list. The first page seen will ask you to associate the file to a particular course, or you can choose to not associate the file to any course. Once a course is chosen click on \fbox{Associate Resource with Selected Course}.
+To create or edit catalog information, press the \textbf{Cat} button next to the rename link in the file list. The first page will ask you to associate the file to a particular course. You can also choose not to associate the file to any course. Once a course is chosen press the \textbf{Associate Resource with Selected Course} button.
The next page allows you to enter the various information. These information are:
@@ -18,7 +18,7 @@
\item Standards
\end{itemize}
-Click on \fbox{Store Catalog Information} to save the information created. Or press on \fbox{Discard Edits and Return to Portfolio} to cancel all edits.
+Click on \textbf{Store Catalog Information} to save the information created. Or press on \textbf{Discard Edits and Return to Portfolio} to cancel all edits.
Index: loncom/html/adm/help/tex/Portfolio_ChangeDirectory.tex
diff -u loncom/html/adm/help/tex/Portfolio_ChangeDirectory.tex:1.1 loncom/html/adm/help/tex/Portfolio_ChangeDirectory.tex:1.2
--- loncom/html/adm/help/tex/Portfolio_ChangeDirectory.tex:1.1 Tue Oct 31 14:22:20 2006
+++ loncom/html/adm/help/tex/Portfolio_ChangeDirectory.tex Mon Nov 27 21:35:53 2006
@@ -1,3 +1,3 @@
\label{Portfolio_ChangeDirectory}
-The current directory you are in is shown before the file list. The complete path to the directory is also shown, starting with the root directory 'Portfolio\'. You can click on any of the directories shown on the path to move to a particular directory. If you need to enter a subdirectory, click on the directory name on the file list.
+The current directory you are in is shown before the file list. The complete path to the directory is also shown, starting with the root directory "Portfolio/". You can click on any of the directories shown on the path to move up the directory tree. If you need to enter a subdirectory, click on the subdirectory name on your file list.
Index: loncom/html/adm/help/tex/Portfolio_CreateDirectory.tex
diff -u loncom/html/adm/help/tex/Portfolio_CreateDirectory.tex:1.1 loncom/html/adm/help/tex/Portfolio_CreateDirectory.tex:1.2
--- loncom/html/adm/help/tex/Portfolio_CreateDirectory.tex:1.1 Tue Oct 31 14:22:20 2006
+++ loncom/html/adm/help/tex/Portfolio_CreateDirectory.tex Mon Nov 27 21:35:53 2006
@@ -1,14 +1,14 @@
\label{Portfolio_CreateDirectory}
-The portfolio can be organized by using directories and subdirectories. To create a subdirectory first make sure that you are in the correct directory. The current directory you are in is shown above the list of files. The current directory indicator starts with the text portfolio/ and is a link. Click on the directory name that you want to enter the directory.
+You can organize the portfolio by using directories and subdirectories. To create a subdirectory make sure that you are in the correct directory first of all (See Changing Directory \ref{Portfolio_ChangeDirectory}). The current directory you are in is shown above the list of files. It is a link having the text "portfolio/".
Once you are in the correct directory:
\begin{enumerate}
-\item Write the name of the new subdirectory in the input box 'Create subdirectory in current directory:'.
-\item Press \fbox{create subdirectory}
+\item Write the name of the new subdirectory in the input box with the label "Create subdirectory in current directory:".
+\item Press \textbf{create subdirectory}
\item A new subdirectory is created. If the name you submit has illegal characters (such as spaces), the illegal characters will be replaced by the underline character '\_'.
\item Press done
\end{enumerate}
-Creating a subdirectory does not put you inside the directory. If you wish to enter the directory you must click the directory name you have just created (\ref{Portfolio_ChangeDirectory}).
+Creating a subdirectory does not put you inside the directory. If you wish to enter the directory you must click the directory name you have just created.
Index: loncom/html/adm/help/tex/Portfolio_DeleteFile.tex
diff -u loncom/html/adm/help/tex/Portfolio_DeleteFile.tex:1.1 loncom/html/adm/help/tex/Portfolio_DeleteFile.tex:1.2
--- loncom/html/adm/help/tex/Portfolio_DeleteFile.tex:1.1 Tue Oct 31 14:22:20 2006
+++ loncom/html/adm/help/tex/Portfolio_DeleteFile.tex Mon Nov 27 21:35:53 2006
@@ -1,11 +1,11 @@
\label{Portfolio_DeleteFile}
-The portfolio allows you to delete some files. Not all files can be deleted. Specifically locked files (files that have been handed in as solutions to a problem) cannot be deleted. Subdirectories cannot be deleted. To delete one or more files:
+The portfolio allows you to delete some files. Locked files (files that have been handed in as solutions to a problem) cannot be deleted. Subdirectories cannot be deleted. To delete one or more files:
\begin{enumerate}
\item Check on the checkboxes next to the filenames you wish to delete.
-\item Once all files in the directory are checked click on \fbox{delete checked files}.
-\item A confirmation screen will appear. Make sure that the filenames are correct. Press continue to delete the file, and cancel to cancel the deletion of the file.
+\item Once all files in the directory are checked press on the \textbf{delete checked files} button.
+\item A confirmation screen will appear. Make sure that the filenames are correct. Press \textbf{Continue} to delete the file, and \textbf{cancel} to cancel the deletion of the file.
\end{enumerate}
File deletion cannot be undone
Index: loncom/html/adm/help/tex/Portfolio_FileList.tex
diff -u loncom/html/adm/help/tex/Portfolio_FileList.tex:1.2 loncom/html/adm/help/tex/Portfolio_FileList.tex:1.3
--- loncom/html/adm/help/tex/Portfolio_FileList.tex:1.2 Mon Nov 6 15:01:59 2006
+++ loncom/html/adm/help/tex/Portfolio_FileList.tex Mon Nov 27 21:35:53 2006
@@ -1,12 +1,14 @@
\label{Portfolio_FileList}
-The file list shows all files and sub-directories contained within this directory. Clicking on a file will open that file. Clicking on a directory will take you inside the directory.
+The file list shows all files and sub-directories contained within this directory. Clicking on a file will open or download that file. Clicking on a directory will take you to that directory.
The file list also has various action icons. The meaning of each of these icons are:
\begin{itemize}
\item folder image: This denotes that the name correspond to a directory.
-\item locked: If you have submitted a file for a problem, you cannot delete this file
-\item checkbox: Check this box and the delete button to delete a files
+\item locked: If you have submitted a file for a problem, you cannot delete or rename this file
+\item checkbox: Check this box and press the \textbf{Delete} button to delete a files
+\item Rename: Click this button to rename files (See Renaming File \ref{Portfolio_RenameFile}).
+\item Cat: Click this button to create a catalog entry for this file (See File Catalogs \ref{Portfolio_Catalog})
\end{itemize}
Index: loncom/html/adm/help/tex/Portfolio_OpenFile.tex
diff -u loncom/html/adm/help/tex/Portfolio_OpenFile.tex:1.1 loncom/html/adm/help/tex/Portfolio_OpenFile.tex:1.2
--- loncom/html/adm/help/tex/Portfolio_OpenFile.tex:1.1 Tue Oct 31 14:22:20 2006
+++ loncom/html/adm/help/tex/Portfolio_OpenFile.tex Mon Nov 27 21:35:53 2006
@@ -1,3 +1,3 @@
\label{Portfolio_OpenFile}
-To open a file, click on the file name on the file list. If you cannot see your file, you may be in the wrong directory, try changing directories.
+To open a file, click on the file name on the file list. If you cannot see your file, you may be in the wrong directory, try changing directories (See Changing Directory \ref{Portfolio_ChangeDirectory}).
Index: loncom/html/adm/help/tex/Portfolio_RenameFile.tex
diff -u loncom/html/adm/help/tex/Portfolio_RenameFile.tex:1.1 loncom/html/adm/help/tex/Portfolio_RenameFile.tex:1.2
--- loncom/html/adm/help/tex/Portfolio_RenameFile.tex:1.1 Tue Oct 31 14:22:20 2006
+++ loncom/html/adm/help/tex/Portfolio_RenameFile.tex Mon Nov 27 21:35:53 2006
@@ -1,5 +1,5 @@
\label{Portfolio_RenameFile}
- You can only rename unlocked files. Click on the \underline{rename} link on the file you wish to rename. The screen will change to a screen with an input box. Type in the new filename in the input box (be sure to write the extension - which is used by the operating system (MS Windows, among others) how to open the file). Press \fbox{continue} if you wish to rename the file. If you do not want to change the file name, press \fbox{Cancel}.
+ You can only rename unlocked files. Click on the \underline{rename} link on the file you wish to rename. The screen will change to a screen with an input box. Type in the new filename in the input box (be sure to write the extension. The extension is information used by the operating system on how to open the file). Press \textbf{continue} if you wish to rename the file. If you do not want to change the file name, press \textbf{Cancel}.
Invalid characters will be replaced by the character '\_'.
Index: loncom/html/adm/help/tex/Portfolio_ShareFile.tex
diff -u loncom/html/adm/help/tex/Portfolio_ShareFile.tex:1.2 loncom/html/adm/help/tex/Portfolio_ShareFile.tex:1.3
--- loncom/html/adm/help/tex/Portfolio_ShareFile.tex:1.2 Sun Nov 5 20:52:00 2006
+++ loncom/html/adm/help/tex/Portfolio_ShareFile.tex Mon Nov 27 21:35:53 2006
@@ -8,4 +8,4 @@
\item Password protected access: To see/download your file, a person must enter the password that you have set.
\end{itemize}
-To change the status of a file, click on the \underline{view/change status} link after the file name.
+To change the status of a file, click on the \underline{view/change status} link after the file name.
Index: loncom/html/adm/help/tex/Portfolio_ShareFile_ChangeSetting.tex
diff -u loncom/html/adm/help/tex/Portfolio_ShareFile_ChangeSetting.tex:1.1 loncom/html/adm/help/tex/Portfolio_ShareFile_ChangeSetting.tex:1.2
--- loncom/html/adm/help/tex/Portfolio_ShareFile_ChangeSetting.tex:1.1 Tue Oct 31 14:22:20 2006
+++ loncom/html/adm/help/tex/Portfolio_ShareFile_ChangeSetting.tex Mon Nov 27 21:35:53 2006
@@ -5,5 +5,5 @@
\begin{enumerate}
\item Change the beginning/end date of the file
\item Check on update checkbox
-\item press \fbox{Proceed} to update your settings
+\item press \textbf{Proceed} to update your settings
\end{enumerate}
Index: loncom/html/adm/help/tex/Portfolio_ShareFile_SetAccess.tex
diff -u loncom/html/adm/help/tex/Portfolio_ShareFile_SetAccess.tex:1.1 loncom/html/adm/help/tex/Portfolio_ShareFile_SetAccess.tex:1.2
--- loncom/html/adm/help/tex/Portfolio_ShareFile_SetAccess.tex:1.1 Tue Oct 31 14:22:20 2006
+++ loncom/html/adm/help/tex/Portfolio_ShareFile_SetAccess.tex Mon Nov 27 21:35:53 2006
@@ -5,10 +5,10 @@
You can set the public/password protected access by:
\begin{enumerate}
\item setting the starting date and the ending date of when your file is to be publicly accessible. The ending date must be after the starting date.
-\item If you wish to have the file public/password protected forever, click on \fbox{no end date}.
+\item If you wish to have the file public/password protected forever, click on \textbf{no end date}.
\item For password protected access, you must write a password. You can then give the password to anyone who you wish to share your files with
\item Click on the activate check box
-\item press \fbox{Proceed} to make your files publicly available.
+\item press \textbf{Proceed} to make your files publicly available.
\end{enumerate}
The URL where this file can be accessed will be given to you. Copy this URL and give the URL to people you wish to share your files with
Index: loncom/html/adm/help/tex/Portfolio_ShareFile_StopAccess.tex
diff -u loncom/html/adm/help/tex/Portfolio_ShareFile_StopAccess.tex:1.1 loncom/html/adm/help/tex/Portfolio_ShareFile_StopAccess.tex:1.2
--- loncom/html/adm/help/tex/Portfolio_ShareFile_StopAccess.tex:1.1 Tue Oct 31 14:22:20 2006
+++ loncom/html/adm/help/tex/Portfolio_ShareFile_StopAccess.tex Mon Nov 27 21:35:53 2006
@@ -1,8 +1,8 @@
\label{Portfolio_ShareFile_StopAccess}
-sIf you no longer wish to set a file to be publicly accessible/password protected (return it to private access):
+If you no longer wish to set a file to be publicly accessible/password protected (return it to private access):
\begin{enumerate}
\item Check on the delete checkbox
-\item Press \fbox{Proceed} to update your settings
+\item Press \textbf{Proceed} to update your settings
\end{enumerate}
--rezaferry1164681356--