Skip to content

Commit 933bb43

Browse files
authored
add guidance for things that have confused submitters (#8152)
* add guidance that has been and issue * add notes on time limits
1 parent 9461369 commit 933bb43

File tree

1 file changed

+11
-2
lines changed

1 file changed

+11
-2
lines changed

docs/CONTRIBUTING.md

Lines changed: 11 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -114,7 +114,7 @@ Example:
114114
GOOD: * [A Very Awesome Book](https://example.org/book.pdf) - Jane Roe (PDF)
115115
```
116116
117-
- Multiple formats:
117+
- Multiple formats (We prefer a single link for each resource. When there is no single link with easy access to different formats, multiple links may make sense. But every link we add creates maintenance burden so we try to avoid it.):
118118
119119
```text
120120
BAD : * [Another Awesome Book](http://example.com/)- John Doe (HTML)
@@ -189,13 +189,22 @@ Our lists provide a minimal set of metadata: titles, URLs, creators, platforms,
189189
- You can shorten author lists with "`et al.`".
190190
- We do not permit links for Creators.
191191
- For compilation or remixed works, the "creator" may need a description. For example, "GoalKicker" or "RIP Tutorial" books are credited as "`Compiled from StackOverflow documentation`".
192+
- We do not include honorifics such as "Prof." or "Dr." in creator names.
193+
194+
195+
##### Time-limited Courses and Trials
196+
197+
- We don't list things that we'll need to remove in six months.
198+
- If a course has a limited enrollment period or duration, we won't list it.
199+
- We can't list resources that are free for a limited period.
192200
193201
194202
##### Platforms and Access Notes
195203
196204
- Courses. Especially for our course lists, the platform is an important part of the resource description. This is because course platforms have different affordances and access models. While we usually won't list a book that requires a registration, many course platforms have affordances that don't work without some sort of account. Example course platforms include Coursera, EdX, Udacity, and Udemy. When a course depends on a platform, the platform name should be listed in parentheses.
197205
- YouTube. We have many courses which consist of YouTube playlists. We do not list YouTube as a platform, we try to list the YouTube creator, which is often a sub-platform.
198-
- YouTube videos. We usually don't link to individual YouTube videos unless they are more than an hour long and are structured like a course or a tutorial.
206+
- YouTube videos. We usually don't link to individual YouTube videos unless they are more than an hour long and are structured like a course or a tutorial. If this is the case, be sure to make a note of it in the PR description.
207+
- No shortened (i.e. youtu.be/xxxx) links!
199208
- Leanpub. Leanpub hosts books with a variety of access models. Sometimes a book can be read without registration; sometimes a book requires a Leanpub account for free access. Given quality of the books and the mixture and fluidity of Leanpub access models, we permit listing of the latter with the access note `*(Leanpub account or valid email requested)*`.
200209
201210

0 commit comments

Comments
 (0)