You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: src/docs/source/docs/memo.md
+5-154Lines changed: 5 additions & 154 deletions
Original file line number
Diff line number
Diff line change
@@ -37,172 +37,23 @@ Steps to Create a Memo
37
37
38
38
8. Next, click on the "Contribution Metadata" tab.
39
39
40
-
9. Complete the "License" field by selecting a license from the drop down menu. This indicates how the content should be licensed.
40
+
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 license as you see fit. Please refer to the [*Licensing*](../licensing) section for more information.
41
41
42
-
10. Next, add optional keyword tags to your memo. Type in a keyword into the search bar to tag to your memo. Select it from the list that pops up. You can add several keyword tags by clicking the "Add another item" button and repeating the above instructions.
42
+
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!
43
43
44
-
5. Add yourself as a contributor by typing the first few letters of your name into the
45
-
“contributor” field. Your screen name should pop up. Select your name. Repeat this process with the names of any other project members who you would
46
-
like to grant access to editing the artifact.
44
+
11. To designate the content as part of a group, select the group's name in the Group Audience field. Select “Public” to make it accessible to all viewers; this is the setting we generally recommend. Select “Private” to limit visibility to Group Members.
47
45
48
-
6. Next, write out your “Critical Commentary” section, making sure to follow any project-
49
-
specific instructions.
46
+
12. Finally, scroll back up to the top of the page and click “Save” to save your work. And remember: all of these settings can be revised at time: private artifacts can be made public later, and vice versa, for example.
50
47
51
-

52
-
53
-
7. Next, upload your artifact by clicking the “Browse” link.
54
-
55
-

56
-
57
-
The browser window should pop up. Click “Browse” and select the name of the file you would like to upload.
58
-
59
-

60
-
61
-
* Click “Open” and then “Next” to upload the file into PECE. Depending on the size of the file it may take a few seconds or minutes to upload; a small icon for the file will appear once uploading is complete.
62
-
* Add Alt Text and Title Text as desired.
63
-
* Click Save.
64
-
65
-
8. Next, cite the source of the artifact in the Source pane, using your platform's preferred citation format.
66
-
67
-
9. In the “creators” pane, credit all the contributors who helped produce the image.
68
-
69
-

70
-
71
-
10. You may also include the format, language, or fieldsite associated with the image if you feel as though they are important or interesting to the meaning or usefulness of the image. Otherwise you may choose to leave them blank.
72
-
73
-
11. For the license, we encourage you to leave it as Attribution, Share Alike CC BY-SA, but you can choose any of the other Creative Commons license as you see fit. Please refer
74
-
to the [*Licensing*](../licensing) section for more information.
75
-
76
-
12. If the image is not ready to be made public, you can alter the permissions of the image. Selecting “Private” limits visibility to you and you alone. Selecting “Restricted” limits visibility to users of PECE designated as “Researchers” (this mostly matters to instances of PECE subject to IRB
77
-
protections). Selecting “Open” make the artifact visible to all internet users. For more information, see [*Content Permissions*](../permissions#content-permissions) section.
78
-
79
-
13. To designate the content as part of a group, select the group's name in the Group Audience field. Select “Public” to make it accessible to all viewers; this is the setting we generally recommend. Select “Private” to limit visibility to Group Members.
80
-
81
-
14. 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!
82
-
83
-

84
-
85
-
15. Only add an expiration date if it is important for the artifact to be deleted from the platform at some point.
86
-
87
-
16. Finally, scroll back up to the top of the page and click “Save” to save your work. And remember: all of these settings can be revised at time: private artifacts can be made public later, and vice versa, for example.
88
-
89
-

90
48
91
49
Frequently Asked Questions
92
50
---------------------------------------
93
51
94
52
### What is the difference between a text artifact and a memo?
95
53
96
-
A text artifact and a fieldnote are technically very similar. However,
97
-
unlike a text artifact, a fieldnote will not have a title; the date the
98
-
fieldnote was created will become the title. Also a fieldnote will
99
-
appear in the field diary on user’s dashboard. If associated with a
100
-
group, a fieldnote will also appear under the Field Diary tab of the
101
-
group’s page, ordered by the date created.
102
-
103
-
Memo - first draft writing to medidiate on findings and data anlysis
104
-
commented on - architectual
105
-
Text Artifact - a piece of data thtat will be analaysed
106
-
annotated - architectual
107
-
108
-
109
-
### What is an artifact bundle, and why would I use it?
110
-
111
-
An artifact bundle is an artifact that links to several other existing
112
-
artifacts. You can create an artifact bundle so that you may annotate a
113
-
group of artifacts together.
114
-
115
-
### What is “critical commentary”?
116
-
117
-
In this field, you should provide commentary on the artifact that documents its significance as an ethnographic objects and why it is relevant to the platform.
118
-
119
-
### How do I select a file that has already been added to the system?
120
-
121
-
When creating a piece of content, under the Image Upload field, click
122
-
the ‘Browse’ button to select a file from the existing PECE library.
123
-
Select the ‘Library’ tab. Choose a file and hit the ‘Submit’ button.
124
-
125
-
### How do I list the creator (author, photographer, composer) of a piece of content when they are not part of the system?
126
-
127
-
When creating an artifact, the Creator field can be used to designate
128
-
the author of a piece of content when that creator is not a user of the
129
-
system. Technically, this field is a tag. This means that if content in
130
-
the system has already been tagged with the creator, you should be given
131
-
the option to select this creator’s name when you begin typing in this
132
-
field. Otherwise, upon saving the artifact, the creator’s name will
133
-
become a new “Creator tag” in the system.
134
-
135
-
### When I edit content, what should I include in the revision log message?
136
-
137
-
If a researcher cites a piece of content on the platform on a particular
138
-
date, and then the content creator revises the content on a later date,
139
-
it is important to be able to track which version of the PECE content
140
-
the researcher was citing. PECE enables users to track changes made to
141
-
content over time. In the revision log message section, users should
142
-
summarize changes they make the content, so that it is easier to track
143
-
the changes. See [*Where can I access older versions of content?*](#where-can-i-access-older-versions-of-content) for where to
144
-
track these changes.
145
-
146
-
### Where can I access older versions of content?
147
-
148
-
When logged in, navigate to the content. Click on the ‘Revisions’ tab.
149
-
If there is no ‘Revisions’ tab, it means that no changes have been made
150
-
to the content. Under the ‘Revisions’ tab, you can click on a date -
151
-
time under the Revisions column to access older versions of the content.
152
-
You can also compare a newer version of content to an older version by
153
-
selecting two versions under the Compare column and clicking the
154
-
‘Compare’ button.
155
-
156
-

157
-
158
-
### I’ve identified my content as having multiple contributors, but those contributors don’t have access to edit the content. What’s going on?
159
-
160
-
Identifying contributors only credits those site users involved in
161
-
contributing the content. It does not grant those users access to edit
162
-
the content. Only the content creator can edit the content.
163
-
164
-
### Where can I find my fieldnotes?
165
-
166
-
Navigate to your ‘Dashboard’. This link will be in the main menu. On
167
-
your dashboard, there will be a tab labeled ‘Field Diary’. Click on this
168
-
tab to access your fieldnotes. They will be ordered chronologically.
169
-
170
-
### Why do my published images appear blurry?
171
-
172
-
Currently, when images are uploaded to PECE, the files are compressed,
173
-
and the image quality downgrades. If this is a problem for your content,
174
-
you should reach out to your site administrator and ask to have the
175
-
quality upgraded.
176
-
177
-
### Can I download files from the platform?
178
-
179
-
You cannot download files that are listed as All Rights Reserved. Please
180
-
see the [*Licensing*](../licensing) section for more information about
181
-
this. Audio files and video files that have been added as a part of Open
182
-
artifacts can be downloaded from the platform. Navigate to the artifact
183
-
page where the file is displayed. In the bottom right hand corner of the
184
-
rendered file, there will be an upside down arrow. Click this button to
185
-
download the file.
186
-
187
-
### 
188
-
189
-
PDF files that have been added as part of Open artifacts can also be
190
-
downloaded from the platform. Navigate to the artifact page where the
191
-
file is displayed. When you hover over the PDF viewer, a bar will
192
-
display at the top. In the upper right hand corner of this bar, there
193
-
will be an upside down arrow. Click this button to download the file.
194
-
195
-

54
+
A text artifact and a memo are similar but conceptually and architecturally different. A text artifact is writing that acts as a piece of data that will be analysed while a memo is a first draft of writing that is used to meditate on findings and data analysis. Architecturally, a memo can be commented on while a text artficat can be annotated.
196
55
197
-
Right now, there is not a simple way to download image files. You can
198
-
right click on the image and Save the file to your computer however.
199
56
200
-
### Can I add a Youtube or Vimeo video to the platform?
201
57
202
-
Currently, you cannot embed a YouTube for Vimeo video in the platform.
203
58
204
-
### Can I add a map to the platform?
205
59
206
-
Currently the only way to share a map on the platform is by capturing an
207
-
image of it and uploading it to the site as an image artifact, or
208
-
alternatively by uploading a link to the map as a Website artifact.
0 commit comments