From b0ca4e0e05de4c1ff52d7b9bd23ccdc5ae5128b3 Mon Sep 17 00:00:00 2001 From: "John M. Horan" Date: Thu, 30 Apr 2020 11:39:17 -0700 Subject: [PATCH] Add initial notes/comments #40 Signed-off-by: John M. Horan --- docs/source/_static/theme_overrides.css | 3 +++ docs/source/aboutcode-docs/gsod-2020.rst | 28 +++++++++++++++++++++++- 2 files changed, 30 insertions(+), 1 deletion(-) diff --git a/docs/source/_static/theme_overrides.css b/docs/source/_static/theme_overrides.css index 65d0e075..e27e933f 100644 --- a/docs/source/_static/theme_overrides.css +++ b/docs/source/_static/theme_overrides.css @@ -99,6 +99,7 @@ div.custom-admonition-important.admonition { color: #000000; background: #ffff66; background: #ffff99; + background: #fff3cd; border-radius: 5px 5px 0px 0px; border-bottom: solid 1px #e8e8e8; } @@ -198,6 +199,7 @@ div.rst-content { /* border: 1px solid #ccffcc; */ /* border: 1px solid #f2f2f2; */ /* border: 1px solid #e6f2ff; */ + border: 1px solid #fff3cd; /* background: #e7f2fa; */ /* background: #e6ffff; */ @@ -205,6 +207,7 @@ div.rst-content { /* background: #ccffcc; */ /* background-color: #f2f2f2; */ /* background: #e6f2ff; */ + background: #fff3cd; /* font-size: 80%; */ font-size: 100%; diff --git a/docs/source/aboutcode-docs/gsod-2020.rst b/docs/source/aboutcode-docs/gsod-2020.rst index 8cf81291..dc5caba0 100644 --- a/docs/source/aboutcode-docs/gsod-2020.rst +++ b/docs/source/aboutcode-docs/gsod-2020.rst @@ -6,7 +6,33 @@ Google Season of Docs 2020 .. admonition:: Caution :class: custom-admonition-caution - This is a clone of the 2019 doc -- not yet updated for 2020. + This WIP began as a clone of our GSoD 2019 page -- :ref:`GSoD2019` -- and is being updated for 2020. Please share your ideas (in writing) for GSoD 2020 projects, using the structure we used for our GSoD 2019 application, i.e., + + - Four categories (aka "functions") drawn from https://documentation.divio.com/ and `this related PyCon Australia 2017 YouTube video `_: + + - Tutorial ideas + - How-To ideas + - Reference ideas + - Discussion ideas + + - Each project "idea" has the following structure: + + - Concise descriptive title followed by equally concise description. + - Level + - Tech + - URLs + - Mentors + +.. admonition:: Note + :class: custom-admonition-note + + For some reason the 2019 ``.rst`` includes a detailed, hand-written TOC, which I expect we'll replace with a Sphinx TOC using ``h1`` et al. headers. + +AboutCode.org is applying to be a mentoring organization for the `Google Season of Docs (GSoD) 2020 `_. + +---- + +:guilabel:`[The text below comes from the 2019 page and has not yet been modified.]` AboutCode has been accepted as a participant in the Google Season of Documents in 2019 as a mentoring org, and is looking for people with technical writing skills. This page contains