diff --git a/src/docs/source/docs/media/pece-essay-1.png b/src/docs/source/docs/media/pece-essay-1.png new file mode 100644 index 000000000..a22a00919 Binary files /dev/null and b/src/docs/source/docs/media/pece-essay-1.png differ diff --git a/src/docs/source/docs/media/pece-essay-10.png b/src/docs/source/docs/media/pece-essay-10.png new file mode 100644 index 000000000..07b86e357 Binary files /dev/null and b/src/docs/source/docs/media/pece-essay-10.png differ diff --git a/src/docs/source/docs/media/pece-essay-11.png b/src/docs/source/docs/media/pece-essay-11.png new file mode 100644 index 000000000..ee4a3e55b Binary files /dev/null and b/src/docs/source/docs/media/pece-essay-11.png differ diff --git a/src/docs/source/docs/media/pece-essay-12.png b/src/docs/source/docs/media/pece-essay-12.png new file mode 100644 index 000000000..e6c200411 Binary files /dev/null and b/src/docs/source/docs/media/pece-essay-12.png differ diff --git a/src/docs/source/docs/media/pece-essay-2.png b/src/docs/source/docs/media/pece-essay-2.png new file mode 100644 index 000000000..720a314be Binary files /dev/null and b/src/docs/source/docs/media/pece-essay-2.png differ diff --git a/src/docs/source/docs/media/pece-essay-3.png b/src/docs/source/docs/media/pece-essay-3.png new file mode 100644 index 000000000..db827d1ea Binary files /dev/null and b/src/docs/source/docs/media/pece-essay-3.png differ diff --git a/src/docs/source/docs/media/pece-essay-4.png b/src/docs/source/docs/media/pece-essay-4.png new file mode 100644 index 000000000..4676fcc41 Binary files /dev/null and b/src/docs/source/docs/media/pece-essay-4.png differ diff --git a/src/docs/source/docs/media/pece-essay-5.png b/src/docs/source/docs/media/pece-essay-5.png new file mode 100644 index 000000000..e60d2da1a Binary files /dev/null and b/src/docs/source/docs/media/pece-essay-5.png differ diff --git a/src/docs/source/docs/media/pece-essay-6.png b/src/docs/source/docs/media/pece-essay-6.png new file mode 100644 index 000000000..6849c9474 Binary files /dev/null and b/src/docs/source/docs/media/pece-essay-6.png differ diff --git a/src/docs/source/docs/media/pece-essay-7.png b/src/docs/source/docs/media/pece-essay-7.png new file mode 100644 index 000000000..ad369424e Binary files /dev/null and b/src/docs/source/docs/media/pece-essay-7.png differ diff --git a/src/docs/source/docs/media/pece-essay-8.png b/src/docs/source/docs/media/pece-essay-8.png new file mode 100644 index 000000000..ed44bd4f3 Binary files /dev/null and b/src/docs/source/docs/media/pece-essay-8.png differ diff --git a/src/docs/source/docs/media/pece-essay-9.png b/src/docs/source/docs/media/pece-essay-9.png new file mode 100644 index 000000000..2c9ce7902 Binary files /dev/null and b/src/docs/source/docs/media/pece-essay-9.png differ diff --git a/src/docs/source/docs/pece-essay.md b/src/docs/source/docs/pece-essay.md new file mode 100644 index 000000000..921280aca --- /dev/null +++ b/src/docs/source/docs/pece-essay.md @@ -0,0 +1,82 @@ +PECE Essay +===================== + +Steps to Create a PECE Essay +--------------------------------------- +1. The process of adding any variety of content to PECE begins by logging in with your screen name and password and clicking “Create Content” in the top right corner. + + ![](media/pece-essay-1.png) + +2. You should now see the "Add content" page. + + As you scroll down the page, you can find thumbnails for creating different forms of new content. Each is organised under a category. "PECE Essay" can be found under the category "Curate". A PECE Essay is a collection of artifacts, memos, and essays, organized into a collage, with text added for context. + + ![](media/pece-essay-2.png) + +3. To create a PECE Essay, click on the "PECE Essay" thumbnail. + + +4. This takes you to the "Create Memo" page. You should now have access to all of the fields you need to fill out in order to create a new memo. First, type the title of your memo in the “Title” field. + + ![](media/pece-essay-3.png) + + ![](media/pece-essay-5.png) + +5. Type your memo into the "Body" field. + To provide a summary of your memo, click the "Edit summary" link next to "Body". + + ![](media/pece-essay-6.png) + +6. Next are two tabs: "Permissions, Authorship, and Groups" and "Contribution Metadata". The "Permissions, Authorship, and Groups" should be automatically opened. + + In the "Edit Permissions and Authorship" section, you should be automatically added as a contributor as your username. Listed contributors have the ability to edit the content, and are also credited as content contributors when the content is published. If there are any other contributors, add them by typing the first few letters of their name into the field. Their screen name should pop up. Select their name. To add more than one contributor other than yourself, click the "Add another item" button and repeat the same process. + + ![](media/pece-essay-7.png) + +7. Next, in the "View Permissions and Groups", you will come across the "Everyone can view this content" toggle. By default, the toggle will be set to on, meaning everyone on the Web can view the content. If you want to restrict access to the content, turn this off. + + If you choose to leave the toggle on, you can still associate the content with a particular group. To do so, complete the "Group association and view access." You can select a group with which to associate the content by typing its name into the field. + + ![](media/pece-essay-8.png) + + If you choose to restrict access to the content, you can designate specific people or groups that will have view access. Add the people who should have view access to this memo by typing their screen name into the "People with view access" field. Add groups whose members should have view access to this memo by typing the group name into the "Group association and view access" field. **Note that if you give a group view access, it will also associate the content with that group. This means the content will appear on the group's page.** + + ![](media/pece-essay-9.png) + +8. Next, click on the "Contribution Metadata" tab. + + ![](media/pece-essay-10.png) + +9. Complete the "License" field by selecting a license from the drop-down menu. This indicates how the content should be licensed. We encourage you to leave it as Attribution, Share Alike CC BY-SA, but you can choose any of the other Creative Commons licenses as you see fit. Please refer to the [*Licensing*](https://creativecommons.org/share-your-work/cclicenses/) section for more information. + + ![](media/pece-essay-11.png) + +10. Next, add optional keyword tags to your memo. Tag the content. As you type, suggested tags will be automatically generated if they exist already in the system. We recommend following theses suggestions and using existing tags if they are not too different from what you were intending, but feel free to make up new tags! + + ![](media/pece-essay-12.png) + +11. Finally, click “Save” at the top of the page to save your work. And remember: all of these settings can be revised at any time: private artifacts can be made public later, and vice versa, for example. + + ![](media/pece-essay-13.png) + +Steps to Edit PECE Essay Layout +--------------------------------------- + +1. Go to the "Layout" tab at the top of the page. + +2. Clear all previous configurations by clicking the delete button as identified below. You will be prompted to confirm this action. Select remove to confirm changes. + +3. Now you can create your own layout from scratch! +Click "Add section". You may now select from a variety of column layouts. For each column layout, select the column width ratio you prefer from the drop-down menu. You will be asked for an administrative label. This is a label for your column layout. You may ignore this section or enter a descriptive label. +Once you have finished creating your column label, click "Add section" to confirm. +Repeat the instructions above to continue configuring your PECE essay layout. + +4. To add content to your columns, click the "+" icon next to "Choose content to add to the essay". +You will then be prompted to choose between a "Basic block" and "More..." + + Selecting the "Basic block" option will open a pop-up. Here, you may add any general writing content. After entering a title and body content, confirm by clicking "Add block". + + Selecting the "More..." option allows the option to create and add specialised content. Select from the list of content fields based on your needs. + +5. To save your changes, click "Save layout". +