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: contribute.md
+8-8Lines changed: 8 additions & 8 deletions
Original file line number
Diff line number
Diff line change
@@ -7,15 +7,15 @@ title: Contribute
7
7
8
8
## A Place to Build Documentation Together
9
9
10
-
[docs.scala-lang.org](http://docs.scala-lang.org) was intended to make it easier for the Scala team and the community at large to easily collect, organize, and "make public" many different types of documentation while making it easy for users to find, interact, and help us improve that documentation.
10
+
[docs.scala-lang.org](https://docs.scala-lang.org) was intended to make it easier for the Scala team and the community at large to easily collect, organize, and "make public" many different types of documentation while making it easy for users to find, interact, and help us improve that documentation.
11
11
12
12
This website is an open-source repository of official Scala documentation, hosted on [github](https://github.com/scala/docs.scala-lang), that is always ready for contributions.
13
13
14
14
### A Need for Better Documentation
15
15
16
16
The availability, depth, and quality of documentation is considered by many to be a huge issue.
17
17
18
-
As Scala continues to mature, it continues to attract more and more interested newcomers and potential adopters who are well accustomed to easy-to-find, abundant, quality documentation (found in other languages, like Java). For many, the learning curve becomes unnecessarily steep, and [people sometimes get frustrated](http://groups.google.com/group/scala-user/browse_thread/thread/29996782cb8428cd/5ade8462ba30b177).
18
+
As Scala continues to mature, it continues to attract more and more interested newcomers and potential adopters who are well accustomed to easy-to-find, abundant, quality documentation (found in other languages, like Java). For many, the learning curve becomes unnecessarily steep, and [people sometimes get frustrated](https://groups.google.com/group/scala-user/browse_thread/thread/29996782cb8428cd/5ade8462ba30b177).
19
19
20
20
If we want Scala to be accessible to more programmers, clear, easy-to-find documentation is essential.
21
21
@@ -35,7 +35,7 @@ Currently, the _types_ of documentation supported in this repository are:
35
35
36
36
This documentation repository is open-source, it lives in [github repository](https://github.com/scala/docs.scala-lang), and is always contribution-ready.
37
37
38
-
It's statically generated from [Markdown](http://en.wikipedia.org/wiki/Markdown) source using [Jekyll](https://github.com/mojombo/jekyll), and hosted on [GitHub Pages](http://pages.github.com/). This workflow was chosen so as to make it as easy as possible for core committers and the community alike to produce HTML documentation, and as easy as possible to publish it in a central location.
38
+
It's statically generated from [Markdown](https://en.wikipedia.org/wiki/Markdown) source using [Jekyll](https://github.com/mojombo/jekyll), and hosted on [GitHub Pages](https://pages.github.com/). This workflow was chosen so as to make it as easy as possible for core committers and the community alike to produce HTML documentation, and as easy as possible to publish it in a central location.
39
39
40
40
The markdown syntax being used supports [Maruku](https://github.com/bhollis/maruku) extensions, and has automatic syntax highlighting, without the need for any tags.
41
41
@@ -46,7 +46,7 @@ Additionally [tut](https://github.com/tpolecat/tut) is used during pull requests
46
46
For one to contribute a document, one must simply
47
47
[fork](https://help.github.com/articles/fork-a-repo/) the
48
48
[repo](https://github.com/scala/docs.scala-lang), write their article in
49
-
[Markdown](http://daringfireball.net/projects/markdown/syntax) (example below), and submit a pull request. That's it. Likely after some edits and discussion, your document will be made live on [docs.scala-lang.org](http://docs.scala-lang.org).
49
+
[Markdown](https://daringfireball.net/projects/markdown/syntax) (example below), and submit a pull request. That's it. Likely after some edits and discussion, your document will be made live on [docs.scala-lang.org](https://docs.scala-lang.org).
50
50
51
51
---
52
52
layout: overview
@@ -55,15 +55,15 @@ For one to contribute a document, one must simply
55
55
56
56
## An h2 Header in Markdown
57
57
58
-
And a paragraph, with a [link](http://www.scala-lang.org).
58
+
And a paragraph, with a [link](https://www.scala-lang.org).
59
59
60
60
One can contribute code by indenting it 4 spaces, or in-line by putting backticks around it like so, `def foo`
61
61
62
62
Everything else is automatically generated for you; tables of contents, and most index pages. And of course, the styling is already taken care of for you.
63
63
64
64
### Criteria for Docs to be Accepted
65
65
66
-
The goal of this documentation repository is to be tighter and more organized than other community-driven documentation platforms, like wikis. As such, any document pulled in for inclusion on [http://docs.scala-lang.org](http://docs.scala-lang.org) must:
66
+
The goal of this documentation repository is to be tighter and more organized than other community-driven documentation platforms, like wikis. As such, any document pulled in for inclusion on [https://docs.scala-lang.org](https://docs.scala-lang.org) must:
67
67
68
68
-**"fit in"** to the repository ( _i.e.,_ it should not be a complete duplicate of another article),
69
69
-**be polished** it must be thorough, complete, correct, organized, and "article-like" (personal programming notes don't quite fit.)
@@ -86,7 +86,7 @@ A guide or an overview that can be logically placed on **one** page must be plac
86
86
title: YOUR TITLE
87
87
---
88
88
89
-
The rest of the document should, of course, be written in [Markdown](http://en.wikipedia.org/wiki/Markdown).
89
+
The rest of the document should, of course, be written in [Markdown](https://en.wikipedia.org/wiki/Markdown).
90
90
91
91
At the moment, `RELEVANT-CATEGORY` corresponds to only a single category, "core," because we are currently focusing on building up documentation of core libraries. However, expect more categories here in the future.
92
92
@@ -113,7 +113,7 @@ A **single** document in the collection must contain a tag in the header, `outof
113
113
114
114
Any overview document may also include comments. To include comments, just add the tag `discourse: true` to your header.
115
115
116
-
Index pages, such as [http://docs.scala-lang.org/overviews/index.html](http://docs.scala-lang.org/overviews/index.html) are automatically generated, assuming documents are properly placed under the correct `RELEVANT-CATEGORY`. So, simply drop your document into the correct folder, and you're done.
116
+
Index pages, such as [https://docs.scala-lang.org/overviews/index.html](https://docs.scala-lang.org/overviews/index.html) are automatically generated, assuming documents are properly placed under the correct `RELEVANT-CATEGORY`. So, simply drop your document into the correct folder, and you're done.
0 commit comments