code.pyret.org/src/web/faq.html at 577121516a26652a0c0189be4dd68f102e29ac24 · brownplt/code.pyret.org · GitHub

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
<!doctype HTML>
<html>
<head>
  <meta http-equiv="Content-Type" content="text/html; charset=utf-8"/>
  <title>{{APP_NAME}}</title>
  <link rel="stylesheet" href="/css/reset.css" />
  <link rel="stylesheet" href="https://ajax.googleapis.com/ajax/libs/jqueryui/1.10.4/themes/smoothness/jquery-ui.css" />
  <link rel="stylesheet" href="/css/shared.css" />
  <link rel="stylesheet" href="/css/my-programs.css" />
  <style>
#header {
 display:flex;
 align-items: center;
}
#header h1 {
  font-size: 18pt;
  font-family: var(--ui-font-stack);
}
ul {
  list-style-type: circle;
}
h4 {
  font-weight: bold;
}
  </style>
</head>
<body>
<div id="header">
  <a id="logo" href="http://www.pyret.org/"></a>
  <h1>Information <code>{{APP_NAME}}</code> Uses and Stores</h1>
</div>
<div id="toolbar">
</div>
<div id="main" style="width: 40em; padding-left: 2em;">

<h3>What permissions does {{APP_NAME}} ask for and why?</h3>

<p>{{APP_NAME}} asks for several permissions when you log in:</p>

<ul>

<li><em>Know who you are on Google</em> and <em>View your email address</em>:
The site needs to know your Google identity because this allows us to give
persistent access to saving to Drive that doesn't expire or require popping up
new windows while you're editing.</li>

<li><em>Add itself to Google Drive</em>: This lets you right-click on Pyret
programs in Google Drive and "Open with Pyret."</li>

<li><em>View and manage Google Drive files and folders that you have opened or
created with this app</em>: This lets the editor see, save, publish, and
re-open programs you create.</li>

</ul>


<h3>Where are things stored in my Drive?</h3>

<p>
The site initially makes a single folder in your Google Drive, called
<code>{{APP_NAME}}</code>, and stores all of your programs there, with the
names you choose for them.  They are all created with you as the owner, and
private to your account.  There is also a directory called
<code>{{APP_NAME}}.compiled</code> that is used for caching compiled copies
of programs.
</p>

<p>
If you <em>publish</em> programs, the site creates a new folder, called
<code>{{APP_NAME}}.shared</code>, and makes <em>publicly-readable
copies</em> of programs you publish in that directory.  If you delete this
files in this folder, links for those programs you have shared with others
will stop working, but any copies others have made will be theirs to keep.
Each time you publish a program, a new copy is created from its current
contents.
</p>

<h3>How can I remove the access {{APP_NAME}} has to my data?</h3>

<p> You can always go to <a
href="https://security.google.com/settings/security/permissions?pli=1">https://security.google.com/settings/security/permissions?pli=1</a>
and remove all access that {{APP_NAME}} has to your account.
Your programs and the created folders will <em>not</em> be
deleted if you do so.  You can always manually delete the folder and its
contents yourself.</p>

<h3>How can I see old versions of my programs?</h3>

<p>
Google Drive automatically stores old versions of your programs as they are
saved (as it does for all files).  You can follow the instructions at <a
href="https://support.google.com/drive/answer/2409045?hl=en">Google's
answer</a> to manage old versions of files that you may have saved over or
renamed.
</p>


<h3 id="logging">What information is sent back to the Pyret team?</h3>

<p>We collect basic information about your use of {{APP_NAME}} to help us
improve the language and editor, and enable some debugging.  We send back
information about errors, authentication, whether features such as the
type-checker are used, and preferences (such as which mode you choose to
display highlights with).
</p>

<p>
We don't log the contents of your programs by default.
</p>

<h4 id="detailed-logging">Contributing Detailed Information</h4>

<p>If you opt to contribute detailed usage information under the "More" menu
(off by default), we will also receive information about the contents of your
programs and the edits you make.</p>

</div>
</body>
</html>