From a8ab14511144af8e2c1b647c4ac49f5b8799714f Mon Sep 17 00:00:00 2001 From: Brian (bex) Exelbierd Date: Jan 18 2018 14:33:31 +0000 Subject: Add GSoC Web via AsciiBinder --- diff --git a/.gitignore b/.gitignore new file mode 100644 index 0000000..462d167 --- /dev/null +++ b/.gitignore @@ -0,0 +1,9 @@ +## AsciiBinder-specific ignores +_preview +_package +*.swp +diag-*.png +diag-*.png.cache + +## Project-specific ignores + diff --git a/_distro_map.yml b/_distro_map.yml new file mode 100644 index 0000000..4aa3187 --- /dev/null +++ b/_distro_map.yml @@ -0,0 +1,11 @@ +--- +fedora: + name: Fedora Mentored Projects + author: Fedora Project + site: main + site_name: Home + site_url: https://docs.fedoraproject.org/ + branches: + master: + name: + dir: master diff --git a/_images/favicon.ico b/_images/favicon.ico new file mode 100644 index 0000000..a912017 Binary files /dev/null and b/_images/favicon.ico differ diff --git a/_images/favicon32x32.png b/_images/favicon32x32.png new file mode 100644 index 0000000..d33bd5e Binary files /dev/null and b/_images/favicon32x32.png differ diff --git a/_images/fedora.svg b/_images/fedora.svg new file mode 100644 index 0000000..e8fd52b --- /dev/null +++ b/_images/fedora.svg @@ -0,0 +1,61 @@ + + + + + + + + + + + + + + + + + + + diff --git a/_images/redhat-logo.png b/_images/redhat-logo.png new file mode 100644 index 0000000..f085f1a Binary files /dev/null and b/_images/redhat-logo.png differ diff --git a/_javascripts/.gitkeep b/_javascripts/.gitkeep new file mode 100644 index 0000000..e69de29 --- /dev/null +++ b/_javascripts/.gitkeep diff --git a/_javascripts/bootstrap-offcanvas.js b/_javascripts/bootstrap-offcanvas.js new file mode 100644 index 0000000..62cf7b6 --- /dev/null +++ b/_javascripts/bootstrap-offcanvas.js @@ -0,0 +1,6 @@ +$(document).ready(function () { + $('[data-toggle="offcanvas"]').click(function () { + $('.sidebar').show(); + $('.row-offcanvas').toggleClass('active'); + }); +}); diff --git a/_stylesheets/asciibinder.css b/_stylesheets/asciibinder.css new file mode 100644 index 0000000..31dba30 --- /dev/null +++ b/_stylesheets/asciibinder.css @@ -0,0 +1,598 @@ +@import url(https://maxcdn.bootstrapcdn.com/font-awesome/4.1.0/css/font-awesome.min.css); +/* ------------------------------------------------------------ +Image: "Spin" https://www.flickr.com/photos/eflon/3655695161/ +Author: eflon https://www.flickr.com/photos/eflon/ +License: https://creativecommons.org/licenses/by/2.0/ +---------------------------------------------------------------*/ +.attribution { + text-align: center; + position: relative; + bottom: -20px; +} +.attribution .btn { + color: #808080; + color: rgba(175,175,175, .65); + font-size: 11px; +} +.attribution .btn:hover { + text-decoration: none; + color: #aaa; +} +.popover-content { + font-size: 12px; + line-height: 1.3; + font-weight: normal; +} + +@media screen and (max-width: 980px) { + body { + margin-bottom: 200px; + } + footer { + text-align: center; + } + footer .text-right { + text-align: center !important; + } + #footer_social .first { + margin-left: 0; + } + #footer_social > a { + top: 24px; + } +} + +.fa-inverse:hover { + color: #ccc; +} + +.collapse a.active { + background-color: #DEEAF4; + color: #000; + position: relative; +} + +.collapse a.active:hover { + text-decoration: none; +} + +.collapse a.active:before { + background-color: #A0C3E5; + content: ""; + display: inline-block; + height: 100%; + left: 0; + position: absolute; + top: 0; + width: 3px; +} + +.main h2, .main .h2 { + border-top: 0px; + padding-top: 10px; + font-size: 28px; +} + +.page-header { + height: 100% !important; +} +.page-header .img-responsive { + display: inline; +} +.page-header h2 { + font-size: 32px; + display: inline; + vertical-align: bottom; +} + +.navbar-brand { + padding: initial; + height: initial; + padding: 12px; +} + +.navbar-header h2 { + display: inline; + position: absolute; + font-weight: bold; + margin-top: 50px ; +} + +.nav > li > a.hover{ + background-color: none; +} + +h1, h2, h3, h4, h5, h6, .h1, .h2, .h3, .h4, .h5, .h6 { + position: relative; +} + +h2 > a.anchor, h3 > a.anchor, h4 > a.anchor, h5 > a.anchor, h6 > a.anchor { + display: block; + font-weight: normal; + margin-left: -1.5ex; + position: absolute; + text-align: center; + text-decoration: none !important; + visibility: hidden; + width: 1.5ex; + z-index: 1001; +} + +h2 > a.anchor:before, h3 > a.anchor:before, h4 > a.anchor:before, h5 > a.anchor:before, h6 > a.anchor:before { + content: "\f0c1"; + display: block; + font-family: FontAwesome; + font-size: 0.7em; + -webkit-font-smoothing: antialiased; + -moz-osx-font-smoothing: grayscale; + padding-top: 0.2em; +} + +h4 > a.anchor:before, h5 > a.anchor:before, h6 > a.anchor:before { + font-size: 1em; +} + +h2:hover > a.anchor, +h2 > a.anchor:hover, +h3:hover > a.anchor, +h3 > a.anchor:hover, +h4:hover > a.anchor, +h4 > a.anchor:hover, +h5:hover > a.anchor, +h5 > a.anchor:hover, +h6:hover > a.anchor, +h6 > a.anchor:hover { + visibility: visible; +} + +.main { + border-left: 1px solid #e7e7e7; + margin-left: -1px; + padding-left: 25px; +} + + +@media (min-width: 768px) { + .main { + padding-left: 30px; + } +} + +/* + * Sidebar + */ + +.nav-header { + font-size: 16px; +} + +.nav-header ul { + font-size: 14px; +} + +.nav-header ul li a { + display: block; + padding: 5px 20px 5px 25px; + font-size: 13px; + font-weight: normal; +} + +.nav-sidebar .fa { + text-align: center; + top: -1px; + width: 14px; +} + +.nav-sidebar li a { + color: inherit; +} + +.nav-sidebar li a:hover { + color: #000; +} + +.nav-sidebar ul li ul.nav-tertiary li a { + padding-left: 50px; +} + +.nav-sidebar > li > a { + padding: 7px 0; +} + +.nav-sidebar > li > a:focus, .nav-sidebar > li > a:hover { + background: transparent; +} + +.sidebar { + font-weight: 300; + display: none; + padding-top: 13px; +} + +@media screen and (max-width: 767px) { + .sidebar { + padding-left: 30px; + padding-right: 0; + } +} + +@media screen and (min-width: 768px) { + .sidebar { + border-right: 1px solid #e7e7e7; + display: block; + } +} + +/* + * Off Canvas + * -------------------------------------------------- + */ + +body, html { + overflow-x: hidden; /* Prevent scroll on narrow devices */ + font-family: "Overpass", sans-serif; +} + +.toggle-nav { + margin-right: 20px; +} + +@media screen and (max-width: 767px) { + .row-offcanvas { + position: relative; + -webkit-transition: all .25s ease-out; + -o-transition: all .25s ease-out; + transition: all .25s ease-out; + } + + .row-offcanvas-right { + right: 0; + } + + .row-offcanvas-left { + left: 0; + } + + .row-offcanvas-right + .sidebar-offcanvas { + right: -75%; /* 8 columns */ + } + + .row-offcanvas-left + .sidebar-offcanvas { + left: -75%; /* 8 columns */ + } + + .row-offcanvas-right.active { + right: 75%; /* 8 columns */ + } + + .row-offcanvas-left.active { + left: 75%; /* 8 columns */ + } + + .sidebar-offcanvas { + overflow: hidden; + position: absolute; + top: 0; + width: 75%; /* 8 columns */ + } +} + + p { + margin: 0 0 1.6em; + } + + /* Remnants of Asciidoctor default stylesheet - remove styles as needed */ + +#map_canvas img, #map_canvas embed, #map_canvas object, .map_canvas img, .map_canvas embed, .map_canvas object { max-width: none !important; } +.left { float: left !important; } +.right { float: right !important; } +.text-left { text-align: left !important; } +.text-right { text-align: right !important; } +.text-center { text-align: center !important; } +.text-justify { text-align: justify !important; } +.hide { display: none; } +.subheader, #content #toctitle, .admonitionblock td.content > .title, .audioblock > .title, .exampleblock > .title, .imageblock > .title, .listingblock > .title, .literalblock > .title, .stemblock > .title, .openblock > .title, .paragraph > .title, .quoteblock > .title, table.tableblock > .title, .verseblock > .title, .videoblock > .title, .dlist > .title, .olist > .title, .ulist > .title, .qlist > .title, .hdlist > .title { line-height: 1.4; color: #7a2518; font-weight: 300; margin-top: 0.2em; margin-bottom: 0.5em; } +abbr, acronym { text-transform: uppercase; font-size: 90%; color: #333333; border-bottom: 1px dotted #dddddd; cursor: help; } +abbr { text-transform: none; } +blockquote { margin: 0 0 1.25em; padding: 0.5625em 1.25em 0 1.1875em; border-left: 3px solid #487c58; } +blockquote cite { display: block; font-size: inherit; color: #454545; } +blockquote cite:before { content: "\2014 \0020"; } +blockquote cite a, blockquote cite a:visited { color: #454545; } +blockquote, blockquote p { line-height: 1.6; color: #6e6e6e; } +@media only screen and (min-width: 768px) { + #toctitle, .sidebarblock > .content > .title { line-height: 1.4; } + #toctitle, .sidebarblock > .content > .title { font-size: 1.6875em; } +} +table { background: white; margin-bottom: 1.25em; border: solid 1px #dddddd; } +table thead, table tfoot { background: whitesmoke; font-weight: bold; } +table thead tr th, table thead tr td, table tfoot tr th, table tfoot tr td { padding: 0.5em 0.625em 0.625em; font-size: inherit; color: #333333; text-align: left; } +table tr th, table tr td { padding: 0.5625em 0.625em; font-size: inherit; color: #333333; } +table tr.even, table tr.alt, table tr:nth-of-type(even) { background: #f9f9f9; } +table thead tr th, table tfoot tr th, table tbody tr td, table tr td, table tfoot tr td { display: table-cell; line-height: 1.6; } +.clearfix:before, .clearfix:after, .float-group:before, .float-group:after { content: " "; display: table; } +.clearfix:after, .float-group:after { clear: both; } +*:not(pre) > code { font-size: inherit; padding: 0; white-space: nowrap; background-color: inherit; border: 0 solid #dddddd; -webkit-border-radius: 4px; border-radius: 4px; text-shadow: none; line-height: 1; } +.keyseq { color: #666666; } +kbd:not(.keyseq) { display: inline-block; color: #333333; font-size: 0.75em; line-height: 1.4; background-color: #f7f7f7; border: 1px solid #ccc; -webkit-border-radius: 3px; border-radius: 3px; -webkit-box-shadow: 0 1px 0 rgba(0, 0, 0, 0.2), 0 0 0 2px white inset; box-shadow: 0 1px 0 rgba(0, 0, 0, 0.2), 0 0 0 2px white inset; margin: -0.15em 0.15em 0 0.15em; padding: 0.2em 0.6em 0.2em 0.5em; vertical-align: middle; white-space: nowrap; } +.keyseq kbd:first-child { margin-left: 0; } +.keyseq kbd:last-child { margin-right: 0; } +.menuseq, .menu { color: #1a1a1a; } +b.button:before, b.button:after { position: relative; top: -1px; font-weight: normal; } +b.button:before { content: "["; padding: 0 3px 0 2px; } +b.button:after { content: "]"; padding: 0 2px 0 3px; } +p a > code:hover { color: #561309; } +#header, #content, #footnotes, #footer { width: 100%; margin-left: auto; margin-right: auto; margin-top: 0; margin-bottom: 0; max-width: 62.5em; *zoom: 1; position: relative; padding-left: 0.9375em; padding-right: 0.9375em; } +#header:before, #header:after, #content:before, #content:after, #footnotes:before, #footnotes:after, #footer:before, #footer:after { content: " "; display: table; } +#header:after, #content:after, #footnotes:after, #footer:after { clear: both; } +#content:before { content: none; } +#header { margin-bottom: 2.5em; } +#header > h1 { color: black; font-weight: 300; border-bottom: 1px solid #d8d8d8; margin-bottom: -28px; padding-bottom: 32px; } +#header span { color: #6e6e6e; } +#header #revnumber { text-transform: capitalize; } +#header br { display: none; } +#header br + span { padding-left: 3px; } +#header br + span:before { content: "\2013 \0020"; } +#header br + span.author { padding-left: 0; } +#header br + span.author:before { content: ", "; } +#toc { border-bottom: 3px double #e5e5e5; padding-top: 1em; padding-bottom: 1.25em; } +#toc > ul { margin-left: 0.25em; } +#toc ul.sectlevel0 > li > a { font-style: italic; } +#toc ul.sectlevel0 ul.sectlevel1 { margin-left: 0; margin-top: 0.5em; margin-bottom: 0.5em; } +#toc ul { font-family: "Open Sans", "DejaVu Sans", "Sans", sans-serif; list-style-type: none; } +#toc a { text-decoration: none; } +#toc a:active { text-decoration: underline; } +#toctitle { color: #7a2518; } +@media only screen and (min-width: 768px) { body.toc2 { padding-left: 15em; padding-right: 0; } + #toc.toc2 { background-color: #fafaf9; position: fixed; width: 15em; left: 0; top: 0; border-right: 1px solid #e5e5e5; border-bottom: 0; z-index: 1000; padding: 1.25em 1em; height: 100%; overflow: auto; } + #toc.toc2 #toctitle { margin-top: 0; font-size: 1.2em; } + #toc.toc2 > ul { font-size: .90em; margin-bottom: 0; } + #toc.toc2 ul ul { margin-left: 0; padding-left: 1em; } + #toc.toc2 ul.sectlevel0 ul.sectlevel1 { padding-left: 0; margin-top: 0.5em; margin-bottom: 0.5em; } + body.toc2.toc-right { padding-left: 0; padding-right: 15em; } + body.toc2.toc-right #toc.toc2 { border-right: 0; border-left: 1px solid #e5e5e5; left: auto; right: 0; } } +@media only screen and (min-width: 1280px) { body.toc2 { padding-left: 20em; padding-right: 0; } + #toc.toc2 { width: 20em; } + #toc.toc2 #toctitle { font-size: 1.375em; } + #toc.toc2 > ul { font-size: 0.95em; } + #toc.toc2 ul ul { padding-left: 1.25em; } + body.toc2.toc-right { padding-left: 0; padding-right: 20em; } } +#content #toc { border-style: solid; border-width: 1px; border-color: #e3e3dd; margin-bottom: 1.25em; padding: 1.25em; background: #fafaf9; border-width: 0; -webkit-border-radius: 4px; border-radius: 4px; } +#content #toc > :first-child { margin-top: 0; } +#content #toc > :last-child { margin-bottom: 0; } +#content #toctitle { font-size: 1.375em; } +#footer { max-width: 100%; background-color: #333333; padding: 1.25em; } +#footer-text { color: #cccccc; line-height: 1.44; } +.audioblock, .imageblock, .literalblock, .listingblock, .stemblock, .verseblock, .videoblock { margin-bottom: 2.5em; } +.admonitionblock td.content > .title, .audioblock > .title, .exampleblock > .title, .imageblock > .title, .listingblock > .title, .literalblock > .title, .stemblock > .title, .openblock > .title, .paragraph > .title, .quoteblock > .title, table.tableblock > .title, .verseblock > .title, .videoblock > .title, .dlist > .title, .olist > .title, .ulist > .title, .qlist > .title, .hdlist > .title { text-rendering: optimizeLegibility; text-align: left; font-family: "Noto Serif", "DejaVu Serif", "Serif", serif; font-weight: normal; font-style: italic; } +table.tableblock > caption.title { white-space: nowrap; overflow: visible; max-width: 0; } +table.tableblock #preamble > .sectionbody > .paragraph:first-of-type p { font-size: inherit; } +.admonitionblock > table { border: 0; background: none; width: 100%; } +.admonitionblock > table td.icon { text-align: center; width: 80px; } +.admonitionblock > table td.icon img { max-width: none; } +.admonitionblock > table td.icon .title { font-weight: 300; text-transform: uppercase; } +.admonitionblock > table td.content { padding-left: 0; padding-right: 1.25em; color: #6e6e6e; } +.admonitionblock > table td.content > :last-child > :last-child { margin-bottom: 0; } +.exampleblock > .content { border-style: solid; border-width: 1px; border-color: #e6e6e6; margin-bottom: 1.25em; padding: 1.25em; background: white; -webkit-border-radius: 4px; border-radius: 4px; } +.exampleblock > .content > :first-child { margin-top: 0; } +.exampleblock > .content > :last-child { margin-bottom: 0; } +.exampleblock > .content h1, .exampleblock > .content h2, .exampleblock > .content h3, .exampleblock > .content #toctitle, .sidebarblock.exampleblock > .content > .title, .exampleblock > .content h4, .exampleblock > .content h5, .exampleblock > .content h6, .exampleblock > .content p { color: #333333; } +.exampleblock > .content h1, .exampleblock > .content h2, .exampleblock > .content h3, .exampleblock > .content #toctitle, .sidebarblock.exampleblock > .content > .title, .exampleblock > .content h4, .exampleblock > .content h5, .exampleblock > .content h6 { line-height: 1; margin-bottom: 0.625em; } +.exampleblock > .content h1.subheader, .exampleblock > .content h2.subheader, .exampleblock > .content h3.subheader, .exampleblock > .content .subheader#toctitle, .sidebarblock.exampleblock > .content > .subheader.title, .exampleblock > .content h4.subheader, .exampleblock > .content h5.subheader, .exampleblock > .content h6.subheader { line-height: 1.4; } +.exampleblock.result > .content { -webkit-box-shadow: 0 1px 8px #e3e3dd; box-shadow: 0 1px 8px #e3e3dd; } +.sidebarblock { border-style: solid; border-width: 1px; border-color: #e3e3dd; margin-top: -1.0em; margin-bottom: 1.6em; margin-left: 1em; padding: .5em; background: #F1F3F5; -webkit-border-radius: 4px; border-radius: 4px; overflow-x: auto; float: right; width: 40%; } +.sidebarblock > :first-child { margin-top: 0; } +.sidebarblock > :last-child { margin-bottom: 0; } +.sidebarblock h1, .sidebarblock h2, .sidebarblock h3, .sidebarblock #toctitle, .sidebarblock > .content > .title, .sidebarblock h4, .sidebarblock h5, .sidebarblock h6, .sidebarblock p { color: #333333; } +.sidebarblock h1, .sidebarblock h2, .sidebarblock h3, .sidebarblock #toctitle, .sidebarblock > .content > .title, .sidebarblock h4, .sidebarblock h5, .sidebarblock h6 { line-height: 1; margin-bottom: 0.625em; } +.sidebarblock h1.subheader, .sidebarblock h2.subheader, .sidebarblock h3.subheader, .sidebarblock .subheader#toctitle, .sidebarblock > .content > .subheader.title, .sidebarblock h4.subheader, .sidebarblock h5.subheader, .sidebarblock h6.subheader { line-height: 1.4; } +.sidebarblock > .content > .title { color: inherit; font-size: 28px; font-weight: 500; margin-top: 0; line-height: 1.6; } +.width50 { width: 50% ! important} +.exampleblock > .content > :last-child > :last-child, .exampleblock > .content .olist > ol > li:last-child > :last-child, .exampleblock > .content .ulist > ul > li:last-child > :last-child, .exampleblock > .content .qlist > ol > li:last-child > :last-child, .sidebarblock > .content > :last-child > :last-child, .sidebarblock > .content .olist > ol > li:last-child > :last-child, .sidebarblock > .content .ulist > ul > li:last-child > :last-child, .sidebarblock > .content .qlist > ol > li:last-child > :last-child { margin-bottom: 0; } +.literalblock pre, .literalblock pre[class], .listingblock pre, .listingblock pre[class] { border: 0px; background-color: #F0F3F5; -webkit-border-radius: 5px; border-radius: 5px; padding: 1.5em 2.5em; word-wrap: break-word; } +.literalblock pre.nowrap, .literalblock pre[class].nowrap, .listingblock pre.nowrap, .listingblock pre[class].nowrap { overflow-x: auto; white-space: pre; word-wrap: normal; } +.literalblock pre > code, .literalblock pre[class] > code, .listingblock pre > code, .listingblock pre[class] > code { display: block; } +.listingblock > .content { position: relative; } +.listingblock:hover code[class*=" language-"]:before { text-transform: uppercase; font-size: 0.9em; color: #999; position: absolute; top: 0.375em; right: 0.375em; } +.listingblock:hover code.asciidoc:before { content: "asciidoc"; } +.listingblock:hover code.clojure:before { content: "clojure"; } +.listingblock:hover code.css:before { content: "css"; } +.listingblock:hover code.go:before { content: "go"; } +.listingblock:hover code.groovy:before { content: "groovy"; } +.listingblock:hover code.html:before { content: "html"; } +.listingblock:hover code.java:before { content: "java"; } +.listingblock:hover code.javascript:before { content: "javascript"; } +.listingblock:hover code.python:before { content: "python"; } +.listingblock:hover code.ruby:before { content: "ruby"; } +.listingblock:hover code.sass:before { content: "sass"; } +.listingblock:hover code.scss:before { content: "scss"; } +.listingblock:hover code.xml:before { content: "xml"; } +.listingblock:hover code.yaml:before { content: "yaml"; } +.listingblock.terminal pre .command:before { content: attr(data-prompt); padding-right: 0.5em; color: #999; } +.listingblock.terminal pre .command:not([data-prompt]):before { content: '$'; } +table.pyhltable { border: 0; margin-bottom: 0; } +table.pyhltable td { vertical-align: top; padding-top: 0; padding-bottom: 0; } +table.pyhltable td.code { padding-left: .75em; padding-right: 0; } +.highlight.pygments .lineno, table.pyhltable td:not(.code) { color: #999; padding-left: 0; padding-right: .5em; border-right: 1px solid #d8d8d8; } +.highlight.pygments .lineno { display: inline-block; margin-right: .25em; } +table.pyhltable .linenodiv { background-color: transparent !important; padding-right: 0 !important; } +.quoteblock { margin: 0 0 1.25em 0; padding: 0.5625em 1.25em 0 1.1875em; border-left: 3px solid #487c58; } +.quoteblock blockquote { margin: 0 0 1.25em 0; padding: 0 0 0.625em 0; border: 0; } +.quoteblock blockquote > .paragraph:last-child p { margin-bottom: 0; } +.quoteblock .attribution { margin-top: -0.625em; padding-bottom: 0.625em; font-size: inherit; color: #454545; line-height: 1.6; } +.quoteblock .attribution br { display: none; } +.quoteblock .attribution cite { display: block; } +table.tableblock { max-width: 100%; } +table.tableblock td .paragraph:last-child p > p:last-child, table.tableblock th > p:last-child, table.tableblock td > p:last-child { margin-bottom: 0; } +table.spread { width: 100%; } +table.tableblock, th.tableblock, td.tableblock { border: 0 solid #dddddd; } +table.grid-all th.tableblock, table.grid-all td.tableblock { border-width: 0 1px 1px 0; } +table.grid-all tfoot > tr > th.tableblock, table.grid-all tfoot > tr > td.tableblock { border-width: 1px 1px 0 0; } +table.grid-cols th.tableblock, table.grid-cols td.tableblock { border-width: 0 1px 0 0; } +table.grid-all * > tr > .tableblock:last-child, table.grid-cols * > tr > .tableblock:last-child { border-right-width: 0; } +table.grid-rows th.tableblock, table.grid-rows td.tableblock { border-width: 0 0 1px 0; } +table.grid-all tbody > tr:last-child > th.tableblock, table.grid-all tbody > tr:last-child > td.tableblock, table.grid-all thead:last-child > tr > th.tableblock, table.grid-rows tbody > tr:last-child > th.tableblock, table.grid-rows tbody > tr:last-child > td.tableblock, table.grid-rows thead:last-child > tr > th.tableblock { border-bottom-width: 0; } +table.grid-rows tfoot > tr > th.tableblock, table.grid-rows tfoot > tr > td.tableblock { border-width: 1px 0 0 0; } +table.frame-all { border-width: 1px; } +table.frame-sides { border-width: 0 1px; } +table.frame-topbot { border-width: 1px 0; } +th.halign-left, td.halign-left { text-align: left; } +th.halign-right, td.halign-right { text-align: right; } +th.halign-center, td.halign-center { text-align: center; } +th.valign-top, td.valign-top { vertical-align: top; } +th.valign-bottom, td.valign-bottom { vertical-align: bottom; } +th.valign-middle, td.valign-middle { vertical-align: middle; } +table thead th, table tfoot th { font-weight: bold; } +tbody tr th { display: table-cell; line-height: 1.6; background: whitesmoke; } +tbody tr th, tbody tr th p, tfoot tr th, tfoot tr th p { color: #333333; font-weight: bold; } +td > div.verse { white-space: pre; } +ul.unstyled, ol.unnumbered, ul.checklist, ul.none { list-style-type: none; } +ul.unstyled, ol.unnumbered, ul.checklist { margin-left: 0.625em; } +ul.checklist li > p:first-child > .fa-check-square-o:first-child, ul.checklist li > p:first-child > input[type="checkbox"]:first-child { margin-right: 0.25em; } +ul.checklist li > p:first-child > input[type="checkbox"]:first-child { position: relative; top: 1px; } +ul.inline { margin: 0 auto 0.625em auto; margin-left: -1.375em; margin-right: 0; padding: 0; list-style: none; overflow: hidden; } +ul.inline > li { list-style: none; float: left; margin-left: 1.375em; display: block; } +ul.inline > li > * { display: block; } +.unstyled dl dt { font-weight: normal; font-style: normal; } +ol.arabic { list-style-type: decimal; } +ol.decimal { list-style-type: decimal-leading-zero; } +ol.loweralpha { list-style-type: lower-alpha; } +ol.upperalpha { list-style-type: upper-alpha; } +ol.lowerroman { list-style-type: lower-roman; } +ol.upperroman { list-style-type: upper-roman; } +ol.lowergreek { list-style-type: lower-greek; } +.hdlist > table, .colist > table { border: 0; background: none; } +.hdlist > table > tbody > tr, .colist > table > tbody > tr { background: none; } +td.hdlist1 { padding-right: .75em; font-weight: bold; } +td.hdlist1, td.hdlist2 { vertical-align: top; } +.literalblock + .colist, .listingblock + .colist { margin-top: -0.5em; } +.colist > table tr > td:first-of-type { padding: 0 .75em; line-height: 1; } +.colist > table tr > td:last-of-type { padding: 0.25em 0; } +.qanda > ol > li > p > em:only-child { color: #1d4b8f; } +.thumb, .th { line-height: 0; display: inline-block; border: solid 4px white; -webkit-box-shadow: 0 0 0 1px #dddddd; box-shadow: 0 0 0 1px #dddddd; } +.imageblock.left, .imageblock[style*="float: left"] { margin: 0.25em 0.625em 1.25em 0; } +.imageblock.right, .imageblock[style*="float: right"] { margin: 0.25em 0 1.25em 0.625em; } +.imageblock > .title { margin-bottom: 0; } +.imageblock.thumb, .imageblock.th { border-width: 6px; } +.imageblock.thumb > .title, .imageblock.th > .title { padding: 0 0.125em; } +.image.left, .image.right { margin-top: 0.25em; margin-bottom: 0.25em; display: inline-block; line-height: 0; } +.image.left { margin-right: 0.625em; } +.image.right { margin-left: 0.625em; } +a.image { text-decoration: none; } +span.footnote, span.footnoteref { vertical-align: super; font-size: 0.875em; } +span.footnote a, span.footnoteref a { text-decoration: none; } +span.footnote a:active, span.footnoteref a:active { text-decoration: underline; } +#footnotes { padding-top: 0.75em; padding-bottom: 0.75em; margin-bottom: 0.625em; } +#footnotes hr { width: 20%; min-width: 6.25em; margin: -.25em 0 .75em 0; border-width: 1px 0 0 0; } +#footnotes .footnote { padding: 0 0.375em; line-height: 1.3; font-size: 0.875em; margin-left: 1.2em; text-indent: -1.2em; margin-bottom: .2em; } +#footnotes .footnote a:first-of-type { font-weight: bold; text-decoration: none; } +#footnotes .footnote:last-of-type { margin-bottom: 0; } +#content #footnotes { margin-top: -0.625em; margin-bottom: 0; padding: 0.75em 0; } +.gist .file-data > table { border: none; background: #fff; width: 100%; margin-bottom: 0; } +.gist .file-data > table td.line-data { width: 99%; } +div.unbreakable { page-break-inside: avoid; } +.replaceable { font-style: italic; font-color: inherit; font-family: inherit; } +.parameter { font-style: italic; font-family: monospace; } +.userinput { font-weight: bold; font-family: monospace; } +.envar { font-weight: bold; font-family: monospace; font-size: 90%; } +.sysitem { font-weight: bold; font-size: 90%; } +.package { font-weight: bold; font-size: 90%; } +.filename { font-weight: bold; font-style: italic; font-size: 90%; } +.big { font-size: larger; } +.small { font-size: smaller; } +.underline { text-decoration: underline; } +.overline { text-decoration: overline; } +.line-through { text-decoration: line-through; } +.aqua { color: #00bfbf; } +.aqua-background { background-color: #00fafa; } +.black { color: black; } +.black-background { background-color: black; } +.blue { color: #0000bf; } +.blue-background { background-color: #0000fa; } +.fuchsia { color: #bf00bf; } +.fuchsia-background { background-color: #fa00fa; } +.gray { color: #606060; } +.gray-background { background-color: #7d7d7d; } +.green { color: #006000; } +.green-background { background-color: #007d00; } +.lime { color: #00bf00; } +.lime-background { background-color: #00fa00; } +.maroon { color: #600000; } +.maroon-background { background-color: #7d0000; } +.navy { color: #000060; } +.navy-background { background-color: #00007d; } +.olive { color: #606000; } +.olive-background { background-color: #7d7d00; } +.purple { color: #600060; } +.purple-background { background-color: #7d007d; } +.red { color: #bf0000; } +.red-background { background-color: #fa0000; } +.silver { color: #909090; } +.silver-background { background-color: #bcbcbc; } +.teal { color: #006060; } +.teal-background { background-color: #007d7d; } +.white { color: #bfbfbf; } +.white-background { background-color: #fafafa; } +.yellow { color: #bfbf00; } +.yellow-background { background-color: #fafa00; } +span.icon > .fa { cursor: default; } +.admonitionblock td.icon [class^="fa icon-"] { font-size: 2.5em; cursor: default; } +.admonitionblock td.icon .icon-note:before { content: "\f05a"; color: #4E9FDD; } +.admonitionblock td.icon .icon-tip:before { content: "\f0eb"; color: #2C8596; } +.admonitionblock td.icon .icon-warning:before { content: "\f071"; color: #ec7a08; } +.admonitionblock td.icon .icon-caution:before { content: "\f06d"; color: #ec7a08; } +.admonitionblock td.icon .icon-important:before { content: "\f06a"; color: #c00; } +.conum[data-value] { display: inline-block; color: white !important; background-color: #333333; -webkit-border-radius: 100px; border-radius: 100px; text-align: center; width: 20px; height: 20px; font-size: 12px; line-height: 20px; font-family: "Open Sans", "Sans", sans-serif; font-style: normal; font-weight: bold; text-indent: -1px; } +.conum[data-value] * { color: white !important; } +.conum[data-value] + b { display: none; } +.conum[data-value]:after { content: attr(data-value); } +pre .conum[data-value] { position: relative; top: -2px; } +b.conum * { color: inherit !important; } +.conum:not([data-value]):empty { display: none; } +.print-only { display: none !important; } +@media print { @page { margin: 1.25cm 0.75cm; } + * { -webkit-box-shadow: none !important; box-shadow: none !important; text-shadow: none !important; } + a, a:visited { color: inherit !important; text-decoration: underline !important; } + a[href^="http:"]:after, a[href^="https:"]:after { content: " (" attr(href) ")"; } + a[href^="#"], a[href^="#"]:visited, a[href^="mailto:"], a[href^="mailto:"]:visited { text-decoration: none !important; } + abbr[title]:after { content: " (" attr(title) ")"; } + pre, blockquote { page-break-inside: avoid; } + code { color: #191919; } + thead { display: table-header-group; } + tr, img { page-break-inside: avoid; } + img { max-width: 100% !important; } + p { orphans: 3; widows: 3; } + h2, h3, #toctitle, .sidebarblock > .content > .title, #toctitle, .sidebarblock > .content > .title { page-break-after: avoid; } + #toc, .sidebarblock { background: none !important; } + #toc { border-bottom: 1px solid #d8d8d8 !important; padding-bottom: 0 !important; } + .sect1 { padding-bottom: 0 !important; } + .sect1 + .sect1 { border: none !important; } + body.book #header { text-align: center; } + body.book #header > h1 { border: none !important; margin: 2.5em 0 1em 0; padding: 0; } + body.book #header span { line-height: 1.6; } + body.book #header br { display: block; } + body.book #header br + span { padding-left: 0; } + body.book #header br + span:before { content: none !important; } + body.book #toc { border: none !important; text-align: left !important; padding: 0 !important; } + #footer { background: none !important; } + #footer-text { color: #333333 !important; } + .hide-on-print { display: none !important; } + .print-only { display: block !important; } + .hide-for-print { display: none !important; } + .show-for-print { display: inherit !important; } } + +.corner-ribbon{ + width: 16em; + background: #3c6eb4 ; + position: absolute; + top: 3em; + right: -4em; + text-align: center; + line-height: 5ex; + color: #dedede; + transform: rotate(45deg); + -webkit-transform: rotate(45deg); + z-index: 999; +} +.corner-ribbon a { color: #FFFFFF; } diff --git a/_templates/_css.html.erb b/_templates/_css.html.erb new file mode 100644 index 0000000..0fca7ae --- /dev/null +++ b/_templates/_css.html.erb @@ -0,0 +1,3 @@ +<%- Dir.glob("_stylesheets/*").sort.each do |sheet| -%> + +<%- end -%> diff --git a/_templates/_nav.html.erb b/_templates/_nav.html.erb new file mode 100644 index 0000000..95a7e5c --- /dev/null +++ b/_templates/_nav.html.erb @@ -0,0 +1,31 @@ + diff --git a/_templates/page.html.erb b/_templates/page.html.erb new file mode 100644 index 0000000..f5d24bf --- /dev/null +++ b/_templates/page.html.erb @@ -0,0 +1,187 @@ + + + + + + + <%= distro %> <%= version %> | <%= [group_title, subgroup_title, topic_title].compact.join(' | ') %> + + + + + + + + + <%= render("_templates/_css.html.erb", :css_path => css_path) %> + + + + + + " rel="shortcut icon" type="text/css"> + + + + + <%- if version == "Rawhide" %> +
">Improve this Page
+ <%- end %> + +
+

+ +

+
    +
  1. + <%= site_name %> +
    2. + + + <%= breadcrumb_subgroup_block %> + +
+
+
+ <%= render("_templates/_nav.html.erb", :navigation => navigation, :group_id => group_id, :topic_id => topic_id, :subgroup_id => subgroup_id, :subtopic_shim => subtopic_shim) %> +
+
+
+

<%= article_title %>

+
+ <%= content %> +
+
+
+
+
+
+
+
+

About

+
+
+
About Fedora
+
Sponsors
+
Fedora Magazine
+
Legal
+
+
    +
  • + +
    • +
  • + +
    • +
  • + +
    • +
+
+
+ +
+

Download

+
+
+
Get Fedora Workstation
+
Get Fedora Server
+
Get Fedora Atomic
+
Fedora Spins
+
Fedora Labs
+
Fedora ARM®
+
Alternative Downloads
+ +
+
+
+ +
+

Support

+
+
+
Get Help
+
Ask Fedora
+
Common Bugs
+
Fedora Developer Portal
+
Installation Guide
+
+
+
+ +
+

Join

+
+
+
Join Fedora
+
Planet Fedora
+
Fedora SIGs
+
Fedora Account System
+
Fedora Community
+
+
+
+
+ +
+
+
+ " alt="Red Hat Logo" /> +
+
+
+
+ + +

© 2017 Red Hat, Inc. and others. Please send any comments or corrections to the documentation team

+
+
+
+ +
+
+
+ + + + + + + + diff --git a/_topic_map.yml b/_topic_map.yml new file mode 100644 index 0000000..868f9e2 --- /dev/null +++ b/_topic_map.yml @@ -0,0 +1,35 @@ +# This configuration file dictates the organization of the topic groups and +# topics on the main page of the doc site for this branch. Each record +# consists of the following: +# +# --- <= Record delimiter +# Name: Origin of the Species <= Display name of topic group +# Dir: origin_of_the_species <= Directory name of topic group +# Topics: +# - Name: The Majestic Marmoset <= Topic name +# File: the_majestic_marmoset <= Topic file under group dir +/- +# - Name: The Curious Crocodile <= Topic 2 name +# File: the_curious_crocodile <= Topic 2 file +# - Name: The Numerous Nematodes <= Sub-topic group name +# Dir: the_numerous_nematodes <= Sub-topic group dir +# Topics: +# - Name: The Wily Worm <= Sub-topic name +# File: the_wily_worm <= Sub-topic file under / +# - Name: The Acrobatic Ascarid <= Sub-topic 2 name +# File: the_acrobatic_ascarid <= Sub-topic 2 file under / +# +# The ordering of the records in this document determines the ordering of the +# topic groups and topics on the main page. +--- +Name: Google Summer of Code +Dir: gsoc +Topics: + - Name: '2018' + Dir: '2018' + Topics: + - Name: Information + File: index + - Name: Ideas + File: ideas + - Name: Application Process + File: application diff --git a/gsoc/2018/application.adoc b/gsoc/2018/application.adoc new file mode 100644 index 0000000..85093a2 --- /dev/null +++ b/gsoc/2018/application.adoc @@ -0,0 +1,137 @@ += Google Summer of Code Application Process + +Interested in applying for Google Summer of Code with Fedora? Here is +how you do that! + +The following are specific guidelines for students to use to submit an +application for the GSoC program through the Fedora Project. Please go +through these carefully and follow them. Applications must be complete +by the deadline. Late applications cannot be accepted. + +== Important + +* Timelines are set by Google for the entire program. Follow the timeline. +* Applications are due in Google's system by March 27, 2018 18:00 +(CEST). +* Applications Must be filed in the Google system. No other +material can be read or accepted. +* The final application is required to be submitted as a PDF. + +== Student Application Process + +=== Learn + +Before you do anything, learn about the program and Fedora. These links +may be helpful: + +* https://summerofcode.withgoogle.com/[GSoC official site] +* link:index.html[Information about Fedora's Participation in GSoC] + +=== Communicate + +Begin link:https://fedoraproject.org/wiki/Communicating_and_getting_help[communicating] with the +community. Our community members can help you understand the existing +project proposals. If you're going to try and propose your own project, +this is a great way to understand the needs of the project and find a +mentor. + +* https://lists.fedoraproject.org/admin/lists/summer-coding.lists.fedoraproject.org[the +summer-coding list] +* https://lists.fedoraproject.org/admin/lists/devel.lists.fedoraproject.org[the +development list]. + +Don't forget to contact mentors on projects that interest you to learn +more. If you're going to propose a project you must have a mentor at the +time of proposal. + +=== Apply + +The application process consists of 5 steps: + +1. Create a FAS account https://admin.fedoraproject.org/accounts[FAS Account Signup / Login Page] +1. Join the fedora-summer-coding mailing list https://lists.fedoraproject.org/admin/lists/summer-coding.lists.fedoraproject.org[Fedora Summer Coding Mailing List] - This list is fairly low volume. +1. Join the devel mailing list https://lists.fedoraproject.org/admin/lists/devel.lists.fedoraproject.org[Devel Mailing List] - this list can be higher volume you may wish to use mail filters appropriately. +1. Sign the FPCA by following the directions https://fedoraproject.org/wiki/Account_System/CompleteFPCA[here] +1. Submit the application/proposal including all requirements in the next section at the https://summerofcode.withgoogle.com/get-started/[Google Summer of Code Site] + +Help is available! Share your application in progress and get feedback. The mentors can help verify your understanding of the project and provide guidance on whether your plan is good. + +If you are submitting an original proposal you must find a mentor. +Proposals without mentors will be rejected. Sharing your proposal is +key to doing this. If you don't want to share your proposal publicly +consider using something like a Google Doc and sharing a link with the +mentor/reviewers. You can also share the link via a private ticket in +our link:https://pagure.io/mentored-projects/issues[Pagure Repository]. +While we would normally not suggest a close-sourced tool such as Google +Docs, in this case it is potentially easier for you because you a) +must have a Google account to be able to apply to the program; and b) +must generate a PDF for your application. + +==== Google Summer of Code Application and Supplemental Material Requirements + +In addition to the information Google requests, the Fedora Project +requires you to submit the following information: + +* What project are you applying to? Seriously consider choosing a +project for proposal from link:ideas.html[ideas list]. While it is +possible to propose your own project, it is often more successful for +you to select one that is already proposed by a mentor. + +* Contact Information +** List your Name, Email Address, Blog URL, and any additional contact +information you think we need. We tend to email so be sure you're +reading your email. + +* About You - Consider these questions +** Do you have any past involvement with the Fedora Project or another +open-source project as a contributor? What kind of contributions have +you made (code and non-code)? Please share any public contributions you +have made (urls, etc.) +** What are you studying? Why? +** What motivates you to do your best? How do you stay focused? Briefly +describe how you organize your work. + +* Why Us? - Consider these questions +** Why do you want to work with the Fedora Project? +** Do you plan to continue contributing to the Fedora Project after +GSoC? If yes, what sub-project(s) are you interested with? + +* Why This Project? - Consider these questions +** Which specific project interests you? If you are proposing your own +project, do it here. If you are proposing the project, explain why it +benefits the community. +** Have you contacted the mentor(s) listed for the project? +** What relevant experience do you have for this project? +** What do you want to gain from this project? +** Describe this project in your own words. What does it mean to you? +What do you think the final deliverable is? + +* Why should we choose you over other applicants? + +* Propose a rough schedule for this project. Ideally you will have +regular deliverables throughout the entire period. + +* What are you specific plans from May to September (eg: Exams in +university, internships, vacations..etc). We need to know if there are +periods of time where you are likely to be unavailable. We are better at +accommodating these periods if we know of them in advance. + +[NOTE] +-- +You must submit a PDF version of all of the information you +prepare with your application using the Google site. The PDF should +consist of the information from the supplemental application +requirements section below. It should also contain any custom project +you are proposing, if any. + +We are not allowed to consider students who do not submit this PDF. +Students will not be judged on the visual layout of their PDF, however +all information must be readable. +-- + +=== Keep communicating + +We cannot overstress the importance of communication. Keep talking, and +listening, to the discussion group, to the sub-projects relevant to your +proposal and to potential mentors. Be patient, as mentors and other +contributors are often very busy people. diff --git a/gsoc/2018/ideas.adoc b/gsoc/2018/ideas.adoc new file mode 100644 index 0000000..2c19189 --- /dev/null +++ b/gsoc/2018/ideas.adoc @@ -0,0 +1,59 @@ += Google Summer of Code 2018 Mentors and Ideas + +NOTE: Google hasn't announced participating organizations yet and we are still +working on idea proposals. Therefore there is nothing to read here yet. + +If you are a student looking forward to participating in +link:index.html[Google Summer of Code with Fedora], please feel free to +browse this idea list. There may be additional ideas added during the +application period. + +**Now please go read the link:index.html#what-can-i-do-today[What +Can I do Today] section of the main page. This has the answers to your +questions and tells you how to apply** + +Do not hesitate to contact the mentors or contributors listed on this +page for any questions or clarification. You can find helpful people on +the IRC channel, or use the mailing list. can be used for getting help +with programming problems. + +== Supporting Mentors + +The following contributors are available to provide general help and +support for the GSoC program If a specific project mentor is busy, you +can contact one of the people below for short-term help on your project +or task. +add yourselves and your wiki page). + +* link:https://fedoraproject.org/wiki/User:Bex[Brian (bex) Exelbierd] (Fedora Community Action and Impact +Coordinator, FCAIC, 🎂, containers, general development, general Linux) +* link:https://fedoraproject.org/wiki/User:Jflory7[Justin W. Flory] (General development, general Linux, +Fedora community, GSoC alumnus, questions about program, misc. advice) +* link:https://fedoraproject.org/wiki/User:Skamath[Sachin S. Kamath] (General Linux, Fedora community, +Metrics, GSoC alumnus, Help with program) +* link:https://fedoraproject.org/wiki/User:Mbriza[Martin Bříza] + +== Idea list + +Coming Soon + +== Open Ideas From Previous Years + +In addition to the above list of ideas, you may want to check out ideas +from previous years and contact the mentors for those projects to see +if they're still interested in mentoring someone this year. + +_Note_: Do not submit a proposal for an idea from a previous year +without contacting the mentor to ensure they will be available to mentor +you. *Without a mentor, proposals will be rejected.* + +* link:https://fedoraproject.org/wiki/Summer_coding_ideas_for_2017[2017] +* link:https://fedoraproject.org/wiki/Summer_coding_ideas_for_2016[2016] +* link:https://fedoraproject.org/wiki/Summer_coding_ideas_for_2015[2015] +* link:https://fedoraproject.org/wiki/Summer_coding_ideas_for_2014[2014] +* link:https://fedoraproject.org/wiki/Summer_coding_ideas_for_2013[2013] +* link:https://fedoraproject.org/wiki/Summer_coding_ideas_for_2012[2012] +* link:https://fedoraproject.org/wiki/Summer_coding_ideas_for_2011[2011] +* link:https://fedoraproject.org/wiki/Summer_coding_ideas_for_2010[2010] +* link:https://fedoraproject.org/wiki/Summer_coding_ideas_for_2009[2009] +* link:https://fedoraproject.org/wiki/Summer_coding_ideas_for_2008[2008] diff --git a/gsoc/2018/images/gsoc_logo.png b/gsoc/2018/images/gsoc_logo.png new file mode 100644 index 0000000..e862ef8 Binary files /dev/null and b/gsoc/2018/images/gsoc_logo.png differ diff --git a/gsoc/2018/index.adoc b/gsoc/2018/index.adoc new file mode 100644 index 0000000..b319c81 --- /dev/null +++ b/gsoc/2018/index.adoc @@ -0,0 +1,242 @@ +[[google-summer-of-code-2017]] += Google Summer of Code 2018 + +IMPORTANT: Student applications are not open yet! + +image::gsoc_logo.png[float="right"] + +This page contains information about Fedora's participation in Google +Summer of Code (GSoC). Please feel free to contact us via the mailing list below +for clarifications and more information. You can also use the IRC channel. + +[[what-can-i-do-today]] +== What can I do today? + +Fedora is still in the process of applying to be a mentoring organization. +Today there is nothing we can do except wait until Google makes a +decision. + +//// +Fedora has been accepted as a mentoring organization. Student +applications open on 12 March. +//// + +[[student-information]] +== Student Information + +Do you want to contribute to one of the world's leading innovative Linux +distributions? GSoC could be your chance. Please refer to the information +below. + +NOTE: Google has not announced organizations yet. + +NOTE: Student applications **are not yet open**. + +* If you're interested in working on an existing project, read up on +the project and the related technology. There is no need to contact the +mentor unless you have a specific question about the project. Don't send +an "I'm interested" email. + +* If you're interested in proposing your own project start looking +around the Fedora Project for a mentor and send your idea to the mailing +list or post it on the wiki. + +//// +* If you're interested in working on a mentor-submitted idea, read +the link:ideas.html[ideas page] and about the project and the related +technology. There is no need to contact the mentor unless you have a +specific question about the project. Don't send an "I'm interested" email. + +* If you're interested in proposing your own project start looking +around the Fedora Project for a mentor and send your idea to the mailing +list or post it on the wiki. A list of potential mentors is also on the +link:ideas.html[ideas page]. +//// + + +* You may also wish to start working on the Fedora specific parts of +the application, see below for more information. Carefully review the +student responsibilities section. + +[[why-spend-your-summer-working-on-foss]] +=== Why spend your summer working on FOSS? + +When you work in the open on free software, you create a body of work +that follows you for the rest of your life. Rather than a coding +assignment done by thousands of other students and relegated to the +bottom of the drawer at semester's end, working in FOSS is a chance to +contribute to a living project. + +Working in FOSS gives you a chance to: + +* Work with real-world, large codebases. +* Collaborate with real engineers and other professionals. +* Contribute to something meaningful while learning and earning. +* Learn tools and processes that are just like what you are going to use +if you work in technology after graduation. +* Make friends and contacts around the globe. +* Attract attention that can lead to an internship or job after +graduation. +* Create lifetime connections and associations. + +[[why-work-with-fedora]] +=== Why work with Fedora? + +Our project is large and diverse. We are very experienced at working +with new contributors and helping them be successful. + +Many of our contributors are long-time contributors. They remain because +they want to keep growing the project and to lend their expertise, +advice and mentoring to you! People who stay around the community and do +good work are noticed. They get hired for jobs from it, including being +hired by Red Hat. Past Google Summer of Code students were hired by Red +Hat, as well as interns in various positions. This is just an example, +as experience and reputation in the Fedora Project communities is +influential in your career in many ways. + +As a long-standing community with many facets, it is possible for you to +find many rewarding sub-projects to work on. + +You should know that contributing to FOSS doesn't require you to have +super programming skills, or super-anything else. You just need be +interested, curious, and willing to become comfortable being +productively lost. This is the state of learning. You learn by finding +your way around and figuring things out with the support of your mentor +and the community. + +If you are new to the Fedora Project, the following material will help +you to get started. + +* link:https://docs.fedoraproject.org/fedora-project/project/fedora-overview.html[Fedora Project Overview] +* link:http://docs.fedoraproject.org[Fedora Technical and Community Documentation] +* link:https://fedoraproject.org/wiki/How_to_use_IRC[How to use IRC] +* link:https://fedoraproject.org/wiki/Development[Information about Development in Fedora] + +[[student-responsibilities]] +=== Student Responsibilities + +You are the key ingredient for your project's success. This project is +important to you, your mentor, and the entire Fedora Community. + +Your responsibilities include: + +* Communicating early and often with your mentor. +* Blogging every week about what you're learning, how you're doing, +challenges and successes. This is key way to keep the entire Fedora +Community informed. +* Working with your mentor on realistic achievable milestones that +provide for regular deliverables and feedback. +* Attending the brief student calls, as announced +* Being accountable for your success and your actions + +[[student-application]] +=== Student Application + +Please read and follow the +link:application.html[student application process]. + +[[mentor-information]] +== Mentor Information + +Want to help the next generation of contributors grow? Want to bring new +contributors to Fedora? Want to advance your projects along their +roadmap? GSoC can be a chance to do all of this. + +=== How to Propose a Project + +If you want to mentor a specific project, think carefully about several things: + +1. Do you have enough time to work on this with the student during the +entire project. You will be helping someone else when they get stuck. +You don't want to become a blocker because you're busy. + +2. It is harder to find success when you are completely certain of how an +idea needs to be implemented; finding a student with the skills and +interest to implement a specific solution is a lot harder than finding +a student with enough skills to respond to a use case need. Also, +students learn more when they help design and guide the project. In +other words, provide guidance and direction but let the student do +some of the "driving." + +3. Where you can have looser ideas, you may be able to find a student +who works as a sort-of intern who can implement a solution to a use +case you have. In past experiences, students going after a use case are +more likely to get somewhere with self-direction and support from you. + +4. Who can help you? Try to find a second mentor for the project. + +If you're interested in working with a student on +a specific project you should post your idea to the +https://pagure.io/mentored-projects/issues[Mentored Projects Issue +Tracker]. Your issue should be tagged *GSoC* and use the *Google Summer +of Code* template. We strongly encourage you to find a second person +to help with mentoring and to solicit feedback on your proposal + +=== Can I be a Mentor Without a Project? + +Yes! You can either: + +* Work with a student who brings an idea to your sub-project. This +requires a different level of communication throughout the project, +but can be the most rewarding. + +* Be a general mentor. This is a person who works with all students +regardless of their project. To become a general mentor please open +an issue in the https://pagure.io/mentored-projects/issues[Mentored +Projects Issue Tracker] offering your help. Please tag the issue with +the *GSoC* tag. + +[[how-to-work-with-students]] +=== How to work with students + +* Read about good mentoring in the +link:http://write.flossmanuals.net/gsoc-mentoring/what-makes-a-good-mentor[Manual +on Mentoring] + +[[mentor-responsibilities]] +Mentor responsibilities +^^^^^^^^^^^^^^^^^^^^^^^ + +You are an essential part of the student's success, the project's +success, and the success for the Fedora Project. + +Your responsibilities include: + +* Being an interface for an identified sub-project or SIG in Fedora. +* Helping students communicate with the overall project and any +upstream. +* Helping the student plan realistic achievable milestones that provide +for regular deliverables and feedback. +* Regular communication with your student. This means you must be +regularly available for the entire project. If you take a holiday you +need to know early and help your student be ready for your brief +absence. +* Attending a brief mentors call, as scheduled. +* Be the final, accountable person for deciding if the student is +successful or not. This is responsibility akin to being a professor or +boss. + +[[communication]] +== Communication + +* *Mailing List (GSoC-related):* link:https://lists.fedoraproject.org/admin/lists/summer-coding@lists.fedoraproject.org/[summer-coding@lists.fedoraproject.org] +* *Mailing List (Technical):* link:https://lists.fedoraproject.org/admin/lists/devel@lists.fedoraproject.org/[devel@lists.fedoraproject.org] +* *IRC:* link:https://webchat.freenode.net/?channels=#fedora-summer-coding[#fedora-summer-coding] or link:https://webchat.freenode.net/?channels=#fedora-devel[#fedora-devel] on Freenode + +[[timeline]] +== Timeline + +Always refer to the +link:https://summerofcode.withgoogle.com/how-it-works/#timeline[Official +Google Summer of Code Timeline] for details. + +[[administration]] +Administration +~~~~~~~~~~~~~~ + +In order to get questions answered or obtain more information related to +this year's GSoC with Fedora, please contact the administrators directly +(please consider CCing the summer-coding list where ever possible). + +1. link:https://fedoraproject.org/wiki/User:Bex[Brian (bex) Exelbierd] (Primary) +2. TBA diff --git a/index-main.html b/index-main.html new file mode 100644 index 0000000..d68edeb --- /dev/null +++ b/index-main.html @@ -0,0 +1,140 @@ + + + + + + + + + + Fedora Documentation + + + + + + + + + + + + + + +
+
+ Fedora +

Documentation

+
+
+
+
+
+
View Docs Here
+
+ +  Click Here to View your Docs + +
+
+ +
+
+
+
+
+
+
+

About

+
+
+
About Fedora
+
Sponsors
+
Fedora Magazine
+
Legal
+
+
    +
  • + +
    • +
  • + +
    • +
  • + +
    • +
+
+
+ +
+

Download

+
+
+
Get Fedora Workstation
+
Get Fedora Server
+
Get Fedora Atomic
+
Fedora Spins
+
Fedora Labs
+
Fedora ARM®
+
Alternative Downloads
+ +
+
+
+ +
+

Support

+
+
+
Get Help
+
Ask Fedora
+
Common Bugs
+
Fedora Developer Portal
+
Installation Guide
+
+
+
+ +
+

Join

+
+
+
Join Fedora
+
Planet Fedora
+
Fedora SIGs
+
Fedora Account System
+
Fedora Community
+
+
+
+
+ +
+
+
+ +
+
+
+
+ + +

© 2017 Red Hat, Inc. and others. Please send any comments or corrections to the documentation team

+
+
+
+ +
+
+
+ + + + + +