From 8de87dfbfe1f5f0485fba0d16a810239d17484e8 Mon Sep 17 00:00:00 2001 From: Brian (bex) Exelbierd Date: Jul 28 2018 09:32:13 +0000 Subject: [PATCH 1/3] antora conversion --- diff --git a/.gitignore b/.gitignore index 462d167..9f3ebf5 100644 --- a/.gitignore +++ b/.gitignore @@ -1,9 +1,3 @@ -## AsciiBinder-specific ignores -_preview -_package -*.swp -diag-*.png -diag-*.png.cache - -## Project-specific ignores - +build +cache +public diff --git a/Common_Content/Feedback.adoc b/Common_Content/Feedback.adoc deleted file mode 100644 index d11787f..0000000 --- a/Common_Content/Feedback.adoc +++ /dev/null @@ -1,26 +0,0 @@ - -:experimental: - -=== We want feedback -indexterm:[feedback,contact information for this manual] -If you find errors or have suggestions for improvement, we want your advice. Submit a report in Bugzilla against the product `{PRODUCT}` and the component `{BOOKID}`. The following link automatically loads this information for you: {BZURL}. - -In Bugzilla: - -. Provide a short summary of the error or your suggestion in the `Summary` field. - -. Copy the following template into the `Description` field and give us the details of the error or suggestion as specifically as you can. If possible, include some surrounding text so we know where the error occurs or the suggestion fits. -+ -[subs="quotes"] ----- -Document URL: - -Section number and name: - -Error or suggestion: - -Additional information: - ----- - -. Click the btn:[Submit Bug] button. diff --git a/Common_Content/Legal_Notice.adoc b/Common_Content/Legal_Notice.adoc deleted file mode 100644 index b65d4a5..0000000 --- a/Common_Content/Legal_Notice.adoc +++ /dev/null @@ -1,22 +0,0 @@ - -:experimental: - -Copyright {YEAR} {HOLDER}. - -The text of and illustrations in this document are licensed by Red Hat under a Creative Commons Attribution–Share Alike 3.0 Unported license ("CC-BY-SA"). An explanation of CC-BY-SA is available at link:++http://creativecommons.org/licenses/by-sa/3.0/++[]. The original authors of this document, and Red Hat, designate the Fedora Project as the "Attribution Party" for purposes of CC-BY-SA. In accordance with CC-BY-SA, if you distribute this document or an adaptation of it, you must provide the URL for the original version. - -Red Hat, as the licensor of this document, waives the right to enforce, and agrees not to assert, Section 4d of CC-BY-SA to the fullest extent permitted by applicable law. - -Red Hat, Red Hat Enterprise Linux, the Shadowman logo, JBoss, MetaMatrix, Fedora, the Infinity Logo, and RHCE are trademarks of Red Hat, Inc., registered in the United States and other countries. - -For guidelines on the permitted uses of the Fedora trademarks, refer to link:++https://fedoraproject.org/wiki/Legal:Trademark_guidelines++[]. - -*Linux* (R) is the registered trademark of Linus Torvalds in the United States and other countries. - -*Java* (R) is a registered trademark of Oracle and/or its affiliates. - -*XFS* (R) is a trademark of Silicon Graphics International Corp. or its subsidiaries in the United States and/or other countries. - -*MySQL* (R) is a registered trademark of MySQL AB in the United States, the European Union and other countries. - -All other trademarks are the property of their respective owners. diff --git a/Common_Content/images/title_logo.svg b/Common_Content/images/title_logo.svg deleted file mode 100644 index e8fd52b..0000000 --- a/Common_Content/images/title_logo.svg +++ /dev/null @@ -1,61 +0,0 @@ - - - - - - - - - - - - - - - - - - - diff --git a/README.md b/README.md deleted file mode 100644 index fd317d7..0000000 --- a/README.md +++ /dev/null @@ -1,41 +0,0 @@ -# Fedora Release Notes - -This is the content repository for the Fedora Installation Guide. - -Please report Issues and submit Pull Requests for **Content Fixes** here. General appearance issues and publishing issues should be reported against the [publisher](https://pagure.io/fedora-docs/docs-fp-o). - -## README for contributors - -Refer to https://fedoraproject.org/wiki/Category:Documentation_beats?rd=Docs/Beats -for content; proofread when adding to git and mark sections and wiki pages as -complete as you progress. - -Use `create-tx-configuration` to maintain .tx/config (thanks Sparks!) - -When shipping an RPM, test, pull POs, test again, tag, bump spec, and build. See -https://fedoraproject.org/wiki/User:Immanetize/Packaging_Docs_in_an_RPM for -detailed instructions. - -Some methods of finding new packages to write about: -https://bodhi.fedoraproject.org/updates/new -https://bodhi.fedoraproject.org/updates/?release=F25&type=newpackage -`bodhi -r f25 -t newpackage` -#~/usr/bin/env python -from fedora.client import BodhiClient; BodhiClient().query(release="F25", type_="newpackage") - -## How to edit this document - -This document is coded in AsciiDoc. The content is in the en-US directory. There is a shared entity file in the en-US directory. Do not edit the content in the Common_Content directory. - -## Testing your changes locally - -To test your changes, first install `asciibinder` - -$ gem install ascii_binder - -To build your changes, from the root directory: - -``` -$ asciibinder package -$ firefox _package/main/index.html -``` diff --git a/_distro_map.yml b/_distro_map.yml deleted file mode 100644 index 402869d..0000000 --- a/_distro_map.yml +++ /dev/null @@ -1,14 +0,0 @@ ---- -fedora: - name: Fedora Release Notes - author: Fedora Documentation Project - site: main - site_name: Home - site_url: https://docs.fedoraproject.org/ - branches: - master: - name: Rawhide - dir: rawhide - f26: - name: 26 - dir: f26 diff --git a/_images/favicon.ico b/_images/favicon.ico deleted file mode 100644 index a912017..0000000 Binary files a/_images/favicon.ico and /dev/null differ diff --git a/_images/favicon32x32.png b/_images/favicon32x32.png deleted file mode 100644 index d33bd5e..0000000 Binary files a/_images/favicon32x32.png and /dev/null differ diff --git a/_images/fedora.svg b/_images/fedora.svg deleted file mode 100644 index e8fd52b..0000000 --- a/_images/fedora.svg +++ /dev/null @@ -1,61 +0,0 @@ - - - - - - - - - - - - - - - - - - - diff --git a/_images/redhat-logo.png b/_images/redhat-logo.png deleted file mode 100644 index f085f1a..0000000 Binary files a/_images/redhat-logo.png and /dev/null differ diff --git a/_javascripts/.gitkeep b/_javascripts/.gitkeep deleted file mode 100644 index e69de29..0000000 --- a/_javascripts/.gitkeep +++ /dev/null diff --git a/_javascripts/bootstrap-offcanvas.js b/_javascripts/bootstrap-offcanvas.js deleted file mode 100644 index 62cf7b6..0000000 --- a/_javascripts/bootstrap-offcanvas.js +++ /dev/null @@ -1,6 +0,0 @@ -$(document).ready(function () { - $('[data-toggle="offcanvas"]').click(function () { - $('.sidebar').show(); - $('.row-offcanvas').toggleClass('active'); - }); -}); diff --git a/_stylesheets/asciibinder.css b/_stylesheets/asciibinder.css deleted file mode 100644 index 0e17a3d..0000000 --- a/_stylesheets/asciibinder.css +++ /dev/null @@ -1,568 +0,0 @@ -@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; -} - -.page-header { - height: 100% !important; -} - -.page-header h2{ - font-size: 28px; -} - -.navbar-brand { - padding: initial; - height: initial; -} - -.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 */ -} - -.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; padding: .5em; background: #F1F3F5; -webkit-border-radius: 4px; border-radius: 4px; overflow-x: auto; } -.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: #7a2518; margin-top: 0; line-height: 1.6; } -.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; } } diff --git a/_templates/_css.html.erb b/_templates/_css.html.erb deleted file mode 100644 index 0fca7ae..0000000 --- a/_templates/_css.html.erb +++ /dev/null @@ -1,3 +0,0 @@ -<%- Dir.glob("_stylesheets/*").sort.each do |sheet| -%> - -<%- end -%> diff --git a/_templates/_footer.html.erb b/_templates/_footer.html.erb deleted file mode 100644 index 88142fa..0000000 --- a/_templates/_footer.html.erb +++ /dev/null @@ -1,88 +0,0 @@ -
-
-
-
-
-

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 websites team

-
-
-
- -
-
-
diff --git a/_templates/_nav.html.erb b/_templates/_nav.html.erb deleted file mode 100644 index 95a7e5c..0000000 --- a/_templates/_nav.html.erb +++ /dev/null @@ -1,31 +0,0 @@ - diff --git a/_templates/page.html.erb b/_templates/page.html.erb deleted file mode 100644 index 517a026..0000000 --- a/_templates/page.html.erb +++ /dev/null @@ -1,181 +0,0 @@ - - - - - - - <%= 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"> - - - - - -
-

- -

-
    -
  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 websites team

-
-
-
- -
-
-
- - - - - - - - diff --git a/_topic_map.yml b/_topic_map.yml deleted file mode 100644 index d380137..0000000 --- a/_topic_map.yml +++ /dev/null @@ -1,96 +0,0 @@ -# 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: Fedora Release Notes -Dir: en-US -Topics: - - Name: Book Information - File: index - - Name: Welcome to Fedora - Dir: welcome - Topics: - - Name: Welcome to Fedora - File: Welcome - - Name: Overview - File: Overview - - Name: Hardware Overview - File: Hardware_Overview - - Name: Feedback - File: Feedback - - Name: Changes in Fedora for System Administrators - Dir: sysadmin - Topics: - - Name: Fedora Modularity - File: Modularity -# - Name: Kernel -# File: Kernel - - Name: Installation - File: Installation - - Name: Security - File: Security -# - Name: Mail Servers -# File: Mail_Servers - - Name: Domain Controllers - File: Domain_Controllers - - Name: ARM Architectures - File: ARM_Architectures - - Name: Packaging - File: Packaging -# - Name: X.Org -# File: Xorg - - Name: Changes in Fedora for Desktop Users - Dir: desktop - Topics: - - Name: Desktop - File: Desktop -# - Name: Networking -# File: Networking -# - Name: Internationalization -# File: I18n - - Name: Changes in Fedora for Developers - Dir: developers - Topics: - - Name: Development Tools - File: Development_Tools - - Name: C and C++ - File: Development_C -# - Name: Containers -# File: Containers -# - Name: D -# File: Development_D - - Name: Go - File: Development_Go -# - Name: Haskell -# File: Development_Haskell - - Name: Java - File: Development_Java - - Name: Perl - File: Development_Perl - - Name: Python - File: Development_Python - - Name: Ruby - File: Development_Ruby - - Name: Web Development - File: Development_Web -# - Name: Revision History -# File: Revision_History diff --git a/antora.yml b/antora.yml new file mode 100644 index 0000000..fcf79d3 --- /dev/null +++ b/antora.yml @@ -0,0 +1,3 @@ +--- +name: fedora +version: f27 diff --git a/build.sh b/build.sh new file mode 100755 index 0000000..c9349e3 --- /dev/null +++ b/build.sh @@ -0,0 +1,16 @@ +#!/bin/sh + +if [ "$(uname)" == "Darwin" ]; then + # Running on macOS. + # Let's assume that the user has the Docker CE installed + # which doesn't require a root password. + docker run --rm -it -v $(pwd):/antora antora/antora --html-url-extension-style=indexify site.yml + +elif [ "$(expr substr $(uname -s) 1 5)" == "Linux" ]; then + # Running on Linux. + # Let's assume that it's running the Docker deamon + # which requires root. + echo "" + echo "This build script is using Docker to run the build in an isolated environment. You might be asked for a root password in order to start it." +sudo docker run --rm -it -v $(pwd):/antora:z antora/antora --html-url-extension-style=indexify site.yml +fi diff --git a/en-US/Author_Group.adoc b/en-US/Author_Group.adoc deleted file mode 100644 index b7ff345..0000000 --- a/en-US/Author_Group.adoc +++ /dev/null @@ -1 +0,0 @@ -.The Fedora Docs Team diff --git a/en-US/Revision_History.adoc b/en-US/Revision_History.adoc deleted file mode 100644 index 03ebe9a..0000000 --- a/en-US/Revision_History.adoc +++ /dev/null @@ -1,8 +0,0 @@ -[[appe-Release_Notes-Revision_History]] -= Revision History -include::en-US/entities.adoc[] - -`26.01-3`:: Sun Jul 30 2017, (docs AT lists.fedoraproject.org), First AsciiDoc version. - -`26.01-2`:: Tue Jul 11 2017, (docs AT lists.fedoraproject.org) - diff --git a/en-US/desktop/Desktop.adoc b/en-US/desktop/Desktop.adoc deleted file mode 100644 index b62157c..0000000 --- a/en-US/desktop/Desktop.adoc +++ /dev/null @@ -1,7 +0,0 @@ -[[sect-desktop]] -= Desktop -include::en-US/entities.adoc[] - -[[sect-desktop-dnfdragora]] -== dnfdragora replaces Yumex-DNF -Previous releases of Fedora have included https://github.com/timlau/yumex-dnf/blob/develop/README.md[Yumex-DNF] as a graphical user interface for package management. Yumex-DNF is no longer under active development and so it has been replaced in Fedora 27 by https://github.com/manatools/dnfdragora[dnfdragora]. dnfdragora is a new DNF frontend that is written in Python 3 and uses https://github.com/libyui/libyui[libYui], the widget abstraction library written by SUSE, so that it can be run using Qt 5, GTK+ 3, or ncurses interfaces. diff --git a/en-US/desktop/I18n.adoc b/en-US/desktop/I18n.adoc deleted file mode 100644 index 025c43c..0000000 --- a/en-US/desktop/I18n.adoc +++ /dev/null @@ -1,3 +0,0 @@ -[[sect-i18n]] -= Internationalization -include::en-US/entities.adoc[] diff --git a/en-US/desktop/Networking.adoc b/en-US/desktop/Networking.adoc deleted file mode 100644 index cae7975..0000000 --- a/en-US/desktop/Networking.adoc +++ /dev/null @@ -1,3 +0,0 @@ -[[sect-networking]] -= Networking -include::en-US/entities.adoc[] diff --git a/en-US/developers/Containers.adoc b/en-US/developers/Containers.adoc deleted file mode 100644 index 36c5c50..0000000 --- a/en-US/developers/Containers.adoc +++ /dev/null @@ -1,4 +0,0 @@ - -[[sect-containers]] -= Containers -include::en-US/entities.adoc[] diff --git a/en-US/developers/Development_C.adoc b/en-US/developers/Development_C.adoc deleted file mode 100644 index a63f5eb..0000000 --- a/en-US/developers/Development_C.adoc +++ /dev/null @@ -1,20 +0,0 @@ -[[sect-c]] -= C and C++ -include::en-US/entities.adoc[] - -[[sect-boost]] -== Boost 1.64 -The http://www.boost.org[Boost C++ libraries] have been upgraded to version 1.64. Apart from a number of bugfixes and improvements to existing libraries, this brings a new library compared to Fedora 26, Boost.Process. -For more information, see the http://www.boost.org/users/history/version_1_64_0.html[Boost 1.64 release notes]. - -[[sect-c-glibc]] -== GNU C Library 2.26 -Fedora 27 ships with version 2.26 of the GNU C Library (glibc). New features include: - -* A per-thread malloc cache has been added that significantly improves the malloc API family of functions on certain multithreaded workloads. -* Unicode 10.0.0 support for character encodings, character type info, and transliteration tables. -* Improvements in the DNS stub resolver including runtime detection of changed DNS servers (/etc/resolv.conf changes) and use of those new servers without needing to restart the process. - -Security improvements include fixes for the following vulnerabilities: CVE-2017-12132, CVE-2017-1000366, CVE-2010-3192, CVE-2017-12133. - -More information about this version of the GNU C Library can be found in https://sourceware.org/ml/libc-alpha/2017-08/msg00010.html[the release notes]. diff --git a/en-US/developers/Development_D.adoc b/en-US/developers/Development_D.adoc deleted file mode 100644 index f79a418..0000000 --- a/en-US/developers/Development_D.adoc +++ /dev/null @@ -1,3 +0,0 @@ -[[sect-d]] -= D -include::en-US/entities.adoc[] diff --git a/en-US/developers/Development_Go.adoc b/en-US/developers/Development_Go.adoc deleted file mode 100644 index 8787ab9..0000000 --- a/en-US/developers/Development_Go.adoc +++ /dev/null @@ -1,11 +0,0 @@ -[[sect-development-go]] -= Go -include::en-US/entities.adoc[] - - -[#go-upgraded-to-1.9] -== Golang 1.9 - -Fedora 27 brings Golang 1.9, which includes performance improvements, bug fixes, and new features. Most notably, support for type aliasing, parallel compilation, and direct bit manipulation has been added. For a complete list of changes, see upstream change notes at link:https://tip.golang.org/doc/go1.9[https://tip.golang.org/doc/go1.9]. - -With this release, support for the ppc64 architecture has been left out from the Fedora Golang packages due to the fact that the ppc64 port of 'GC' is not feature-complete. diff --git a/en-US/developers/Development_Haskell.adoc b/en-US/developers/Development_Haskell.adoc deleted file mode 100644 index 7aee91c..0000000 --- a/en-US/developers/Development_Haskell.adoc +++ /dev/null @@ -1,3 +0,0 @@ -[[sect-haskell]] -= Haskell -include::en-US/entities.adoc[] diff --git a/en-US/developers/Development_Java.adoc b/en-US/developers/Development_Java.adoc deleted file mode 100644 index f2d1465..0000000 --- a/en-US/developers/Development_Java.adoc +++ /dev/null @@ -1,17 +0,0 @@ -[[sect-java]] -= Java -include::en-US/entities.adoc[] - -[[sect-java-java9]] -== Java 9 Technology Preview -Fedora 27 includes a technology preview of Java 9, offered through the `java-9-openjdk` and `java-9-openjdk-devel` and new `java-9-openjdk-jmod` packages. - -Java 8 remains the default JDK for this release. The inclusion of Java 9 / OpenJDK 9 will allow developers to develop and test their applications for the next version of Java in parallel while everyone can continue using the stable Java 8 for daily use. - -More information about the new features of OpenJDK 9 is available from http://openjdk.java.net/projects/jdk9/[the OpenJDK website]. - -[[sect-java-decouple]] -== System Java Setting Decoupled from Java Command Setting -In earlier versions of Fedora, Java applications installed from RPMs were run in the JVM that was found using the `PATH` environment variable. From this release, Java applications will be run using the default system JVM, which will be OpenJDK 8 in Fedora 27, without refering to `PATH`. Users will still be able to override the default by using the `JAVA_HOME` environment variable. - -More detail about this revised configuration can be found on the https://fedoraproject.org/wiki/Changes/Decouple_system_java_setting_from_java_command_setting[change page]. diff --git a/en-US/developers/Development_Perl.adoc b/en-US/developers/Development_Perl.adoc deleted file mode 100644 index 538e068..0000000 --- a/en-US/developers/Development_Perl.adoc +++ /dev/null @@ -1,22 +0,0 @@ -[[sect-perl]] -= Perl -include::en-US/entities.adoc[] - -[[sect-perl-core]] -== Packaging of the Perl Core Modules -The release of Fedora 27 brings a change in the way that the Perl core modules are packaged by Fedora. In Perl, the core modules are the standard set of modules that ship with the Perl interpreter. Previously in Fedora, the Perl core modules were split into a number of subpackages in such a way that installing the `perl` package did not install the full set of Perl core modules. This behaviour was not what was expected by most Perl users and so, from Fedora 27, installing the `perl` package now installs the full set of Perl core modules. It is still possible to install only a minimal Perl interpreter by installing just the `perl-interpreter` package. - -[[sect-perl-526]] -== Perl 5.26 -A new version of perl is released every year and version 5.26 is 2017's stable release. This release includes three updates with widespread effects: - -."." no longer in @INC -For security reasons, the current directory (".") is no longer included by default at the end of the module search path (@INC). This may have widespread implications for the building, testing and installing of modules, and for the execution of scripts. - -.`do` may now warn -`do` now gives a deprecation warning when it fails to load a file which it would have loaded had "." been in @INC. - -.In regular expression patterns, a literal left brace "{" must be escaped -Unescaped literal { characters in regular expression patterns are no longer permitted. Use a pattern like "\{" or "[{]" to specify a match to a left brace. - -For more information about this release, please see the http://search.cpan.org/dist/perl-5.26.0/pod/perldelta.pod[5.26.0 perldelta] web page. diff --git a/en-US/developers/Development_Python.adoc b/en-US/developers/Development_Python.adoc deleted file mode 100644 index 3ca9748..0000000 --- a/en-US/developers/Development_Python.adoc +++ /dev/null @@ -1,7 +0,0 @@ -[[sect-python]] -= Python -include::en-US/entities.adoc[] - -[[sect-python-sudo-pip]] -== Making sudo pip Safe (Again) -The location where sudo pip3 installs modules has been changed to /usr/local/lib/pythonX.Y/site-packages, and sudo pip3 is henceforth safer to use. No other changes in user experience are expected. Sudo pip3 is not considered a standard way to install Python packages. Virtual environment and pip3 install --user should still be the prefered options. Additionally, Fedora will increase it's compliance with the Filesystem Hierarchy Standard, as user-installed host-specific Python modules will now be correctly located under /usr/local. diff --git a/en-US/developers/Development_Ruby.adoc b/en-US/developers/Development_Ruby.adoc deleted file mode 100644 index ac63427..0000000 --- a/en-US/developers/Development_Ruby.adoc +++ /dev/null @@ -1,15 +0,0 @@ -[[sect-ruby]] -= Ruby -include::en-US/entities.adoc[] - -[[sect-ruby-rails]] -== Ruby on Rails 5.1 -Ruby on Rails has been updated to version 5.1 in Fedora 27. Some of the highlights in Rails 5.1 include: - -* Drop jQuery as a default dependency -* Yarn, Webpack and Capybara integration -* Encrypted secrets support -* Parameterized mailers support -* Virtual/generated column support for MySQL and MariaDB - -For more information, please see the http://guides.rubyonrails.org/v5.1/5_1_release_notes.html[Ruby on Rails 5.1 Release Notes]. diff --git a/en-US/developers/Development_Tools.adoc b/en-US/developers/Development_Tools.adoc deleted file mode 100644 index ec933c9..0000000 --- a/en-US/developers/Development_Tools.adoc +++ /dev/null @@ -1,17 +0,0 @@ -[[sect-development-tools]] -= Development Tools -include::en-US/entities.adoc[] - -[[sect-development-tools-debuginfo]] -== Debuginfo Package Improvements -To observe what a program is doing, Fedora provides additional meta-data about code that is installed and runs on your system. These can be used together with tracers, profilers and debuggers to better understand what is running on your system (or to understand crashes or failures better). Previously, these debug info meta-data packages were fairly large, containing lots of information about multiple sub-packages together. With Fedora 27, these debug info meta-data packages have been split up into smaller sub-packages, making it possible to install just the debuginfo for one specific sub-package or library. The source files needed for debuggers (but not necessarily for tracers and profilers) have been separated out into their own debugsource package and it is now possible to install multiple, different versions or architectures of the debug info packages at the same time. For example, when trying to introspect a program installed in a container or virtual machine that is a different version of the package installed on the host, or when both a 32 bit and 64 bit version of a library is available. - -[[sect-development-tools-bodhi]] -== Bodhi Now Handles Non-RPM Artifacts -Bodhi, the https://bodhi.fedoraproject.org/[Fedora Updates System], can now handle more than just RPM files. If it can be tagged in https://koji.fedoraproject.org/koji/[Koji], it should be accepted by Bodhi. The release of Bodhi 3.0.0 enables: - -* Support for updating non-RPM artifacts, like modules. -* Support for complex package dependencies, which enables Fedora to start packaging Rust packages and allows Fedora to do a better job expressing valid ranges of supported dependency versions for existing packages. -* Support, via https://pagure.io/pungi[Pungi], for generating OSTrees that are more consistent with Fedora’s release day OSTrees. - -More information about this update to Bodhi can be found in the https://bodhi.fedoraproject.org/docs/release_notes.html[Bodhi 3.0.0 release notes] and the related https://fedoraproject.org/wiki/Changes/BodhiNonRPMArtifacts[Fedora change page]. diff --git a/en-US/developers/Development_Web.adoc b/en-US/developers/Development_Web.adoc deleted file mode 100644 index a128680..0000000 --- a/en-US/developers/Development_Web.adoc +++ /dev/null @@ -1,14 +0,0 @@ -[[sect-web-development]] -= Web Development -include::en-US/entities.adoc[] - -[[sect-web-development-node]] -== Node.js 8 -Fedora 27 includes Node.js 8, which is the current version of the platform. This release line will become a Node.js Long Term Support (LTS) release at the end of October 2017. Some of the highlights of Node.js 8 include: - -* http2 support -* experimental support for Node API (N-API) -* a significant update to the V8 JavaScript runtime that includes major improvements in performance and developer-facing APIs -* version 5 of the npm client - -For more information about the range of updates and new features introduced in Node.js 8, please see the https://medium.com/the-node-js-collection/node-js-8-big-improvements-for-the-debugging-and-native-module-ecosystem-58454861f2fc[release announcement]. diff --git a/en-US/entities.adoc b/en-US/entities.adoc deleted file mode 100644 index fb9b41f..0000000 --- a/en-US/entities.adoc +++ /dev/null @@ -1,11 +0,0 @@ - -:BOOKID: release-notes -:BZURL: https://pagure.io/release-notes -:COMMONBUGS_URL: http://fedoraproject.org/wiki/Common_F26_bugs -:HOLDER: Fedora Project Contributors -:KERNEL: 4.8 -:NEXTVER: 28 -:PREVVER: 26 -:PRODUCT: Fedora Documentation -:PRODVER: 27 -:YEAR: 2017 diff --git a/en-US/index.adoc b/en-US/index.adoc deleted file mode 100644 index 40bc738..0000000 --- a/en-US/index.adoc +++ /dev/null @@ -1,14 +0,0 @@ -= Release Notes -include::en-US/entities.adoc[] - -Release Notes for Fedora {PRODVER} - -[abstract] --- -This document provides the release notes for Fedora {PRODVER}. It describes major changes offered as compared to Fedora {PREVVER}. --- - -image:../../Common_Content/images/title_logo.svg[Fedora Logo] -include::Common_Content/Legal_Notice.adoc[] - -include::en-US/Author_Group.adoc[] diff --git a/en-US/sysadmin/ARM_Architectures.adoc b/en-US/sysadmin/ARM_Architectures.adoc deleted file mode 100644 index 3d1ce33..0000000 --- a/en-US/sysadmin/ARM_Architectures.adoc +++ /dev/null @@ -1,9 +0,0 @@ -[[sect-ARM]] -= ARM Architectures -include::en-US/entities.adoc[] - -[[sect-ARM-aarch64]] -== aarch64 Single Board Computer Disk Images -Fedora now includes disk images for 64 bit ARM (aarch64) Single Board Computer (SBC) devices, for example the Pine64 or Raspberry Pi 3. In the same manner as for the ARMv7 SBC images, there will be a single disk image for each of Fedora's Minimal, Server and Workstation Editions that will cover all supported devices. - -More information about Fedora on ARM and the supported devices can be found on the https://fedoraproject.org/wiki/Architectures/ARM[ARM Architecture page]. diff --git a/en-US/sysadmin/Domain_Controllers.adoc b/en-US/sysadmin/Domain_Controllers.adoc deleted file mode 100644 index 85f8080..0000000 --- a/en-US/sysadmin/Domain_Controllers.adoc +++ /dev/null @@ -1,49 +0,0 @@ -[[sect-domain-controllers]] -= Domain Controllers -include::en-US/entities.adoc[] - -[[sect-domain-controllers-samba-changes]] -== Samba changes - -Samba project completed conversion of Samba AD DC to support MIT Kerberos. Fedora 27 is the first Fedora version to include Samba AD domain controller functionality. - -The Samba AD process will take care of starting the MIT KDC and it will load a KDB (Kerberos Database) driver to access the Samba AD database. When -provisioning an AD DC using 'samba-tool' it will take care of creating a correct kdc.conf file for the MIT KDC. - -For further details, see: link:++https://wiki.samba.org/index.php/Running_a_Samba_AD_DC_with_MIT_Kerberos_KDC++[upstream's documentation]. - -Important changes to note: - -* Two different deployment modes are now supported for Samba domain controller: - - Traditional domain controller (NT-style domain controller) - - Active Directory domain controller (new mode). -* Samba upgraded to version 4.7. -* The default for `client max protocol` has changed to `SMB3_11`, which means that `smbclient` (and related commands) will work against servers without SMB1 support. It is possible to use the `m/--max-protocol` option to overwrite the `client max protocol` option temporarily. -* Encryption support in `smbclient` (option `-e/--encrypt`) works with SMB3 servers as well (Windows Server 2012 or later, Samba 4.0.0 or later). -* The change to `SMB3_11` as default also means `smbclient` no longer negotiates `SMB1` unix extensions by default, when talking to a Samba server with `unix extensions = yes`. As a result, some commands are not available, e.g. `posix_encrypt`, `posix_open`, `posix_mkdir`, `posix_rmdir`, `posix_unlink`, `posix_whoami`, `getfacl` and `symlink`. Using `-mNT1` reenables them, if the server supports SMB1. -* `smbclient` learned a new command 'deltree' that is able to do a recursive deletion of a directory tree. -* The dynamic port range for RPC services has been changed from the old default value `1024-1300` to `49152-65535`. This port range is not only used by a Samba AD DC, but also applies to all other server roles including NT4-style domain controllers. The new value has been defined by Microsoft in Windows Server 2008 and newer versions. To make it easier for Administrators to control those port ranges we use the same default and make it configurable with the option: `rpc server dynamic port range`. The `rpc server port` option sets the first available port from the new `rpc server dynamic port range` option. The option `rpc server port` only applies to Samba provisioned as an AD DC. - -Samba AD DC with MIT Kerberos does not have all the features of Heimdal Kerberos build. Missing features, compared to a Heimdal Kerberos build, are: - -* PKINIT support -* S4U2SELF/S4U2PROXY support -* Read-only domain controller support (RODC). This functionality is not fully working with Heimdal Kerberos build either. - - -[[sect-domain-controllers-freeipa-changes]] -== FreeIPA changes - -FreeIPA has been upgraded to version 4.6. This is a major FreeIPA release which supports Python 3. - -Major changes compared to FreeIPA 4.4 which was shipped in Fedora 26: - -* FreeIPA is using Python 3 now -* Security defaults are in line with the rest of Fedora. In particular, newly issued certificates default to SHA-256. -* Smartcard support was added to FreeIPA and SSSD. New `ipa-advise` recipes are available to configure FreeIPA-enrolled clients and servers to support smartcard authentication. -* FreeIPA web UI can now be accessed using smartcard authentication. This feature is not enabled by default. -* Kerberos PKINIT is enabled by default on new installations with an integrated Certificate Authority. This allows to use smartcards to login to FreeIPA-enrolled hosts and obtain Kerberos tickets. -* Kerberos authentication indicator `pkinit` is automatically issued when Kerberos PKINIT pre-authentication succeeds. As result, elevated security requirements can be assigned to Kerberos services that require to only smartcard (`pkinit`), multi-factor (`otp`), or RADIUS (`radius`) authentication to succeed prior accessing them. -* Users from trusted Active Directory domains can now login to FreeIPA web UI and perform self-service operations. -* FreeIPA can now be installed in an environment subject to FIPS 140-2 requirements. - diff --git a/en-US/sysadmin/Installation.adoc b/en-US/sysadmin/Installation.adoc deleted file mode 100644 index 05d2144..0000000 --- a/en-US/sysadmin/Installation.adoc +++ /dev/null @@ -1,7 +0,0 @@ -[[sect-installation]] -= Installation -include::en-US/entities.adoc[] - -[[sect-installation-trim]] -== TRIM pass down to encrypted disks -With this change Fedora becomes more friendly to SSD drives. During the installation procedure, any newly created storage with LUKS encryption (newly formatted encrypted partitions, logical volumes, and so on) is configured to use the `discard` option which enables https://en.wikipedia.org/wiki/Trim_(computing)[TRIM]. This potentially increases the lifetime of SSD drives while **not** affecting encrypted data security and it has no effect on HDDs. diff --git a/en-US/sysadmin/Kernel.adoc b/en-US/sysadmin/Kernel.adoc deleted file mode 100644 index c586f75..0000000 --- a/en-US/sysadmin/Kernel.adoc +++ /dev/null @@ -1,3 +0,0 @@ -[[sect-kernel]] -= Kernel -include::en-US/entities.adoc[] diff --git a/en-US/sysadmin/Mail_Servers.adoc b/en-US/sysadmin/Mail_Servers.adoc deleted file mode 100644 index ff03dc1..0000000 --- a/en-US/sysadmin/Mail_Servers.adoc +++ /dev/null @@ -1,3 +0,0 @@ -[[sect-mail-servers]] -= Mail Servers -include::en-US/entities.adoc[] diff --git a/en-US/sysadmin/Modularity.adoc b/en-US/sysadmin/Modularity.adoc deleted file mode 100644 index f18121e..0000000 --- a/en-US/sysadmin/Modularity.adoc +++ /dev/null @@ -1,21 +0,0 @@ -[[sect-modularity]] -= Fedora Modularity -include::en-US/entities.adoc[] - -Modularity is the initiative to disconnect the lifecycle of applications from each other and from the lifecycle of the operating system, while still maintaining the ease of use of a typical Linux distribution. This work has produced two changes that have been incorporated into Fedora 27: Host and Platform and Modular Server. - -[[sect-modularity-host-platform]] -== Host and Platform -The Host and Platform change is an evolution of the Base Runtime module concept that was introduced in the Fedora 26 Boltron Release, splitting the minimal system further into independent modules, which gives greater flexibility when composing and maintaining the base system. - -* The Host module delivers hardware enablement components such as the kernel, bootloaders, firmware, possibly additional device drivers and other components closely linked to these. - -* The Platform module defines the operating system release and includes various base userspace components ranging from the C library and init system to system management & deployment tools, container runtime and possibly several services that are commonly considered to be part of the base system experience. - -The Host and Platform modules are independent, making it possible to run the same Host with different Platforms and vice versa. Each of the two modules has its own life cycle, update cadence and versioning scheme. - -[[sect-modularity-modular-server]] -== Modular Server -The Modular Server change promotes the work done in the Fedora 26 Boltron Release to the Fedora Server Edition. In Fedora 27, the Fedora Server Edition is created and delivered using the Modularity infrastructure pipeline and the Host and Platform design concept. - -Other Fedora Editions and Spins will not change in this release; users who want to use Fedora to create a server (as opposed to capital-S Fedora Server) without Modularity can use one of the other editions, for example the Fedora Cloud Base Image, or the "Everything" network installer. diff --git a/en-US/sysadmin/Packaging.adoc b/en-US/sysadmin/Packaging.adoc deleted file mode 100644 index 90db1ca..0000000 --- a/en-US/sysadmin/Packaging.adoc +++ /dev/null @@ -1,15 +0,0 @@ -[[sect-packaging]] -= Packaging -include::en-US/entities.adoc[] - -[[sect-packaging-rpm]] -== RPM 4.14 -This Fedora release contains RPM 4.14. Users' general experience of RPM will benefit from the bugfixes and from the better handling of invalid data. Packagers can take advantage of: - - * Better error reporting by the macro engine - * Dependency generators now properly support rich (boolean) dependencies - * New `with`, `without` and `unless` rich operators - -The maximum supported header size has been significantly raised in RPM 4.14. This cannot be tracked with `rpmlib()` dependencies as that would require accessing the header, so attempting to access packages with a header larger than 32MB will cause an abrupt failure with ALL older RPM versions. - -For more information please see the http://rpm.org/wiki/Releases/4.14.0[RPM 4.14 Release Notes]. diff --git a/en-US/sysadmin/Security.adoc b/en-US/sysadmin/Security.adoc deleted file mode 100644 index 8fe1e6d..0000000 --- a/en-US/sysadmin/Security.adoc +++ /dev/null @@ -1,47 +0,0 @@ -[[sect-security]] -= Security -include::en-US/entities.adoc[] - -[[sect-security-kerberos-kcm]] -== Kerberos KCM credential cache by default -Fedora 27 defaults to a new Kerberos credential cache type called Kerberos Cache Manager (KCM), implemented in the sssd-kcm service, that is better suited for containerized environments and also provides a better user experience in the general case. Key features of KCM include: - -* Kerberos credential caches are handled by a userspace deamon with a UNIX socket entry point. That means the UIDs and GIDs of the cache owners are subject to UID namespacing, which is beneficial in containerized environments. -* The UNIX socket can be mounted into containers on demand, thus allowing one or more containers to share a single Kerberos credential cache. -* The KCM deamon is stateful. While no functionality that benefits from that is implemented in F-27, the deamon will allow automatic refreshes of a user's Kerberos credentials if needed. - -Information about using KCM can be found in `man sssd-kcm` and also in `man sssd-secrets`, because KCM uses sssd-secrets for data storage. Additional information is contained in the https://docs.pagure.org/SSSD.sssd/design_pages/kcm.html[SSSD Design Page for KCM]. - -[[sect-security-krb5-appl]] -== krb5-appl Packages Removed -The `krb5-appl-clients` and `krb5-appl-servers` packages are considered to be obsolete and have been removed from Fedora. These packages provided Kerberos-aware telnet, ftp, rcp, rsh, and rlogin clients and servers. Users should to move to more modern security tools, such as openssh. - - -[#sect-defauilt-ciopher-in-openvpn-changed-to-256-bit-aes-gcm] -== Default cipher in OpenVPN changed to 256-bit AES-GCM - -OpenVPN configurations utilizing the newer `openvpn-server@.service` unit file now use a stronger cipher for the VPN tunnel by default. The default is changed from the Blowfish algorithm using 128-bit keys to the newer AES-GCM algorithm with 256-bit keys. - -To ensure backwards compatibility, this new default also enables clients still using the not recommended Blowfish algorithm to connect by utilizing the `--ncp-ciphers` feature being available in OpenVPN{nbsp}2.4. - -To facilitate an easy migration path away from Blowfish for clients not supporting AES-GCM, these clients can now add or change the `--cipher` option in the client configuration to either `AES-256-CBC` or `AES-128-CBC` without needing to do any other server changes. - - -[#sect-openshh-server-now-follows-system-wide-crypto-policies] -== OpenSSH Server now follows system-wide crypto policies - -Fedora defines system-wide crypto policies, which are followed by cryptographic libraries and tools, including OpenSSH clients. This allows administrators to use different system-wide security levels. With this update, OpenSSH Server adheres to these system-wide crypto policies, too. - -This modification adds environment variables that specify enabled algorithms. The information is passed to the `sshd` daemon on the command line. It is, therefore, necessary to restart the `sshd` service for changes to crypto-policy configuration to take effect. - - -[#sect-ssh-1-support-removed-from-openssh] -== SSH-1 support removed from OpenSSH - -The SSH-1 protocol is obsolete and no longer considered secure. As such, it is not supported by the default OpenSSH client binaries packaged for Fedora. This changes removes support for the SSH-1 protocol altogether by removing the *openssh-clients-ssh1* subpackage. - - -[#sect-libcurl-switches-to-using-openssl] -== libcurl switches to using OpenSSL - -The *libcurl* library now uses OpenSSL for TLS and crypto (instead of NSS). TLS certificates and keys stored in the NSS database need to be exported to files for *libcurl* to be able to load them. See link:http://pki.fedoraproject.org/wiki/NSS_Database[http://pki.fedoraproject.org/wiki/NSS_Database] for instructions on how to work with the NSS database. diff --git a/en-US/sysadmin/Xorg.adoc b/en-US/sysadmin/Xorg.adoc deleted file mode 100644 index 297f213..0000000 --- a/en-US/sysadmin/Xorg.adoc +++ /dev/null @@ -1,3 +0,0 @@ -[[sect-x-org]] -= X.Org -include::en-US/entities.adoc[] diff --git a/en-US/welcome/Feedback.adoc b/en-US/welcome/Feedback.adoc deleted file mode 100644 index e96e078..0000000 --- a/en-US/welcome/Feedback.adoc +++ /dev/null @@ -1,19 +0,0 @@ -[[sect-Release_Notes-Feedback]] -= Feedback -include::en-US/entities.adoc[] - -Thank you for taking the time to provide your comments, suggestions, and bug reports to the Fedora community; this helps improve the state of Fedora, Linux, and free software worldwide. - -== Providing Feedback on Fedora Software - -To provide feedback on Fedora software or other system elements, please refer to link:++http://fedoraproject.org/wiki/BugsAndFeatureRequests++[Bugs And Feature Requests]. A list of commonly reported bugs and known issues for this release is available from link:{COMMONBUGS_URL}[Common F26 Bugs] on the wiki. - -== Providing Feedback on Release Notes - -If you feel these release notes could be improved in any way, you can provide your feedback directly to the beat writers. There are several ways to provide feedback, in order of preference: - -* If you have a Fedora account, edit content directly at link:++http://fedoraproject.org/wiki/Docs/Beats++[Docs-Beats] page on the wiki. - -* Fill out a bug request using link:{BZURL}[http://pagure.io/] - *This link is ONLY for feedback on the release notes themselves.* Refer to the admonition above for details. - -* E-mail the Release-Note mailing list at link:mailto:relnotes@fedoraproject.org[relnotes@fedoraproject.org]. diff --git a/en-US/welcome/Hardware_Overview.adoc b/en-US/welcome/Hardware_Overview.adoc deleted file mode 100644 index fe8b852..0000000 --- a/en-US/welcome/Hardware_Overview.adoc +++ /dev/null @@ -1,77 +0,0 @@ -[[sect-hardware-overview]] -= Hardware Overview -include::en-US/entities.adoc[] - -Fedora {PRODVER} provides software to suit a wide variety of applications. The storage, memory and processing requirements vary depending on usage. For example, a high traffic database server requires much more memory and storage than a business desktop, which in turn has higher requirements than a single-purpose virtual machine. - -[[hardware_overview-specs]] -== Minimum System Configuration - -The figures below are a recommended minimum for the default installation. Your requirements may differ, and most applications will benefit from more than the minimum resources. - -* 1GHz or faster processor - -* 1GB System Memory - -* 10GB unallocated drive space - -.Low memory installations -[NOTE] -==== -Fedora {PRODVER} can be installed and used on systems with limited resources for some applications. Text, VNC, or kickstart installations are advised over graphical installation for systems with very low memory. Larger package sets require more memory during installation, so users with less than 768MB of system memory may have better results preforming a minimal install and adding to it afterward. - -For best results on systems with less than 1GB of memory, use the DVD installation image. -==== - -[[hardware_overview-resolution]] -== Display resolution - -.Graphical Installation requires 800x600 resolution or higher -[NOTE] -==== -Graphical installation of Fedora requires a minimum screen resolution of 800x600. Owners of devices with lower resolution, such as some netbooks, should use text or VNC installation. - -Once installed, Fedora will support these lower resolution devices. The minimum resolution requirement applies only to graphical installation. -==== - -[[hardware_overview-graphics]] -== Graphics Hardware - -[[hardware_overview-graphics-legacy_gpus]] -=== Minimum Hardware for Accelerated Desktops - -Fedora {PRODVER} supports most display adapters. Modern, feature-rich desktop environments like *GNOME3* and *KDE Plasma Workspaces* use video devices to provide 3D-accelerated desktops. Older graphics hardware may *not support* acceleration: - -* Intel prior to GMA9xx - -* NVIDIA prior to NV30 (GeForce FX5xxx series) - -* Radeon prior to R300 (Radeon 9500) - -[[hardware_overview-graphics-cpu_acceleration]] -=== CPU Accelerated Graphics - -Systems with older or no graphics acceleration devices can have accelerated desktop environments using *LLVMpipe* technology, which uses the CPU to render graphics. *LLVMpipe* requires a processor with `SSE2` extensions. The extensions supported by your processor are listed in the `flags:` section of `/proc/cpuinfo` - -[[hardware_overview-graphics-desktops]] -=== Choosing a Desktop Environment for your hardware - -Fedora {PRODVER}'s default desktop environment, *GNOME3*, functions best with hardware acceleration. Alternative desktops are recommended for users with older graphics hardware or those seeing insufficient performance with *LLVMpipe*. - -Desktop environments can be added to an existing installation and selected at login. To list the available desktops, use the [command]`dnf grouplist` command: - ----- -# dnf grouplist -v hidden | grep desktop ----- - -Install the desired group: - ----- -# dnf groupinstall "KDE Plasma Workspaces" ----- - -Or, use the short group name to install: - ----- -# dnf install @mate-desktop-environment ----- diff --git a/en-US/welcome/Overview.adoc b/en-US/welcome/Overview.adoc deleted file mode 100644 index 0e8a1c4..0000000 --- a/en-US/welcome/Overview.adoc +++ /dev/null @@ -1,7 +0,0 @@ -[[sect-overview]] -= Overview -include::en-US/entities.adoc[] - -As always, Fedora continues to develop and integrate the latest free and open source software. The following sections provide a brief overview of major changes from the last release of Fedora. - -More detailed information about changes in this release can be found on the link:https://fedoraproject.org/wiki/Releases/{PRODVER}/ChangeSet[Fedora Project Wiki]. diff --git a/en-US/welcome/Welcome.adoc b/en-US/welcome/Welcome.adoc deleted file mode 100644 index 42d1df2..0000000 --- a/en-US/welcome/Welcome.adoc +++ /dev/null @@ -1,37 +0,0 @@ -[[sect-welcome_to_fedora]] -= Welcome to Fedora -include::en-US/entities.adoc[] - -The Fedora Project is a partnership of Free software community members from around the globe. The Fedora Project builds open source software communities and produces a Linux distribution called Fedora. - -The Fedora Project's mission is to lead the advancement of Free and open source software and content as a collaborative community. The three elements of this mission are clear: - -* The Fedora Project always strives to lead, not follow. - -* The Fedora Project consistently seeks to create, improve, and spread Free/Libre code and content. - -* The Fedora Project succeeds through shared action on the part of many people throughout our community. - -To find out more general information about Fedora, refer to the following pages, on the Fedora Project Wiki: - -* link:++http://fedoraproject.org/wiki/Overview++[Fedora Overview] - -* link:++http://fedoraproject.org/wiki/FAQ++[Fedora FAQ] - -* link:++http://fedoraproject.org/wiki/Communicate++[Help and Discussions] - -* link:++http://fedoraproject.org/wiki/Join++[Participate in the Fedora Project] - -[[sect-need-help]] -== Need Help? - -There are a number of places you can get assistance should you run into problems. - -If you run into a problem and would like some assistance, go to link:++http://ask.fedoraproject.org++[]. Many answers are already there, but if you don't find yours, you can simply post a new question. This has the advantage that anyone else with the same problem can find the answer, too. - -You may also find assistance on the `#fedora` channel on the IRC net `irc.freenode.net`. Keep in mind that the channel is populated by volunteers wanting to help, but folks knowledgeable about a specific topic might not always be available. - -[[sect-providing-help]] -== Want to Contribute? - -You can help the Fedora Project community continue to improve Fedora if you file bug reports and enhancement requests. Refer to link:++http://fedoraproject.org/wiki/BugsAndFeatureRequests++[Bugs And Feature Requests] on the Fedora Wiki for more information about bug and feature reporting. Thank you for your participation. diff --git a/index-main.html b/index-main.html deleted file mode 100644 index 207bfd0..0000000 --- a/index-main.html +++ /dev/null @@ -1,141 +0,0 @@ - - - - - - - - - Fedora Documentation Website - - - - - - - - - - - -
-
-
- -
-
-
-
-

Fedora Documentation Site

-

Test Build.

-
-
-
Fedora Documentation
-
- -  Fedora 26 Documentation - - -  Rawhide Documentation - -
-
-
-
-
-
-
-
-
-

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
-
Release Notes
-
-
-
- -
-

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 websites team

-
-
-
- -
-
-
- - - - - - diff --git a/modules/release-notes/assets/images/title_logo.svg b/modules/release-notes/assets/images/title_logo.svg new file mode 100644 index 0000000..e8fd52b --- /dev/null +++ b/modules/release-notes/assets/images/title_logo.svg @@ -0,0 +1,61 @@ + + + + + + + + + + + + + + + + + + + diff --git a/modules/release-notes/nav.adoc b/modules/release-notes/nav.adoc new file mode 100644 index 0000000..2669532 --- /dev/null +++ b/modules/release-notes/nav.adoc @@ -0,0 +1,24 @@ +* xref:index.adoc[Book Information] +* Welcome to Fedora +** xref:welcome/Welcome.adoc[Welcome to Fedora] +** xref:welcome/Overview.adoc[Overview] +** xref:welcome/Hardware_Overview.adoc[Hardware Overview] +** xref:welcome/Feedback.adoc[Feedback] +* Changes in Fedora for System Administrators +** xref:sysadmin/Modularity.adoc[Fedora Modularity] +** xref:sysadmin/Installation.adoc[Installation] +** xref:sysadmin/Security.adoc[Security] +** xref:sysadmin/Domain_Controllers.adoc[Domain Controllers] +** xref:sysadmin/ARM_Architectures.adoc[ARM Architectures] +** xref:sysadmin/Packaging.adoc[Packaging] +* Changes in Fedora for Desktop Users +** xref:desktop/Desktop.adoc[Desktop] +* Changes in Fedora for Developers +** xref:developers/Development_Tools.adoc[Development Tools] +** xref:developers/Development_C.adoc[C and C++] +** xref:developers/Development_Go.adoc[Go] +** xref:developers/Development_Java.adoc[Java] +** xref:developers/Development_Perl.adoc[Perl] +** xref:developers/Development_Python.adoc[Python] +** xref:developers/Development_Ruby.adoc[Ruby] +** xref:developers/Development_Web.adoc[Web Development] diff --git a/modules/release-notes/pages/Revision_History.adoc b/modules/release-notes/pages/Revision_History.adoc new file mode 100644 index 0000000..7d29756 --- /dev/null +++ b/modules/release-notes/pages/Revision_History.adoc @@ -0,0 +1,8 @@ +[[appe-Release_Notes-Revision_History]] += Revision History +include::{partialsdir}/entities.adoc[] + +`26.01-3`:: Sun Jul 30 2017, (docs AT lists.fedoraproject.org), First AsciiDoc version. + +`26.01-2`:: Tue Jul 11 2017, (docs AT lists.fedoraproject.org) + diff --git a/modules/release-notes/pages/_partials/Author_Group.adoc b/modules/release-notes/pages/_partials/Author_Group.adoc new file mode 100644 index 0000000..b7ff345 --- /dev/null +++ b/modules/release-notes/pages/_partials/Author_Group.adoc @@ -0,0 +1 @@ +.The Fedora Docs Team diff --git a/modules/release-notes/pages/_partials/Feedback.adoc b/modules/release-notes/pages/_partials/Feedback.adoc new file mode 100644 index 0000000..d11787f --- /dev/null +++ b/modules/release-notes/pages/_partials/Feedback.adoc @@ -0,0 +1,26 @@ + +:experimental: + +=== We want feedback +indexterm:[feedback,contact information for this manual] +If you find errors or have suggestions for improvement, we want your advice. Submit a report in Bugzilla against the product `{PRODUCT}` and the component `{BOOKID}`. The following link automatically loads this information for you: {BZURL}. + +In Bugzilla: + +. Provide a short summary of the error or your suggestion in the `Summary` field. + +. Copy the following template into the `Description` field and give us the details of the error or suggestion as specifically as you can. If possible, include some surrounding text so we know where the error occurs or the suggestion fits. ++ +[subs="quotes"] +---- +Document URL: + +Section number and name: + +Error or suggestion: + +Additional information: + +---- + +. Click the btn:[Submit Bug] button. diff --git a/modules/release-notes/pages/_partials/Legal_Notice.adoc b/modules/release-notes/pages/_partials/Legal_Notice.adoc new file mode 100644 index 0000000..b65d4a5 --- /dev/null +++ b/modules/release-notes/pages/_partials/Legal_Notice.adoc @@ -0,0 +1,22 @@ + +:experimental: + +Copyright {YEAR} {HOLDER}. + +The text of and illustrations in this document are licensed by Red Hat under a Creative Commons Attribution–Share Alike 3.0 Unported license ("CC-BY-SA"). An explanation of CC-BY-SA is available at link:++http://creativecommons.org/licenses/by-sa/3.0/++[]. The original authors of this document, and Red Hat, designate the Fedora Project as the "Attribution Party" for purposes of CC-BY-SA. In accordance with CC-BY-SA, if you distribute this document or an adaptation of it, you must provide the URL for the original version. + +Red Hat, as the licensor of this document, waives the right to enforce, and agrees not to assert, Section 4d of CC-BY-SA to the fullest extent permitted by applicable law. + +Red Hat, Red Hat Enterprise Linux, the Shadowman logo, JBoss, MetaMatrix, Fedora, the Infinity Logo, and RHCE are trademarks of Red Hat, Inc., registered in the United States and other countries. + +For guidelines on the permitted uses of the Fedora trademarks, refer to link:++https://fedoraproject.org/wiki/Legal:Trademark_guidelines++[]. + +*Linux* (R) is the registered trademark of Linus Torvalds in the United States and other countries. + +*Java* (R) is a registered trademark of Oracle and/or its affiliates. + +*XFS* (R) is a trademark of Silicon Graphics International Corp. or its subsidiaries in the United States and/or other countries. + +*MySQL* (R) is a registered trademark of MySQL AB in the United States, the European Union and other countries. + +All other trademarks are the property of their respective owners. diff --git a/modules/release-notes/pages/_partials/entities.adoc b/modules/release-notes/pages/_partials/entities.adoc new file mode 100644 index 0000000..fb9b41f --- /dev/null +++ b/modules/release-notes/pages/_partials/entities.adoc @@ -0,0 +1,11 @@ + +:BOOKID: release-notes +:BZURL: https://pagure.io/release-notes +:COMMONBUGS_URL: http://fedoraproject.org/wiki/Common_F26_bugs +:HOLDER: Fedora Project Contributors +:KERNEL: 4.8 +:NEXTVER: 28 +:PREVVER: 26 +:PRODUCT: Fedora Documentation +:PRODVER: 27 +:YEAR: 2017 diff --git a/modules/release-notes/pages/desktop/Desktop.adoc b/modules/release-notes/pages/desktop/Desktop.adoc new file mode 100644 index 0000000..4a15017 --- /dev/null +++ b/modules/release-notes/pages/desktop/Desktop.adoc @@ -0,0 +1,7 @@ +[[sect-desktop]] += Desktop +include::{partialsdir}/entities.adoc[] + +[[sect-desktop-dnfdragora]] +== dnfdragora replaces Yumex-DNF +Previous releases of Fedora have included https://github.com/timlau/yumex-dnf/blob/develop/README.md[Yumex-DNF] as a graphical user interface for package management. Yumex-DNF is no longer under active development and so it has been replaced in Fedora 27 by https://github.com/manatools/dnfdragora[dnfdragora]. dnfdragora is a new DNF frontend that is written in Python 3 and uses https://github.com/libyui/libyui[libYui], the widget abstraction library written by SUSE, so that it can be run using Qt 5, GTK+ 3, or ncurses interfaces. diff --git a/modules/release-notes/pages/desktop/I18n.adoc b/modules/release-notes/pages/desktop/I18n.adoc new file mode 100644 index 0000000..6d58e60 --- /dev/null +++ b/modules/release-notes/pages/desktop/I18n.adoc @@ -0,0 +1,3 @@ +[[sect-i18n]] += Internationalization +include::{partialsdir}/entities.adoc[] diff --git a/modules/release-notes/pages/desktop/Networking.adoc b/modules/release-notes/pages/desktop/Networking.adoc new file mode 100644 index 0000000..8df1062 --- /dev/null +++ b/modules/release-notes/pages/desktop/Networking.adoc @@ -0,0 +1,3 @@ +[[sect-networking]] += Networking +include::{partialsdir}/entities.adoc[] diff --git a/modules/release-notes/pages/developers/Containers.adoc b/modules/release-notes/pages/developers/Containers.adoc new file mode 100644 index 0000000..6a5b85b --- /dev/null +++ b/modules/release-notes/pages/developers/Containers.adoc @@ -0,0 +1,4 @@ + +[[sect-containers]] += Containers +include::{partialsdir}/entities.adoc[] diff --git a/modules/release-notes/pages/developers/Development_C.adoc b/modules/release-notes/pages/developers/Development_C.adoc new file mode 100644 index 0000000..e84443c --- /dev/null +++ b/modules/release-notes/pages/developers/Development_C.adoc @@ -0,0 +1,20 @@ +[[sect-c]] += C and C++ +include::{partialsdir}/entities.adoc[] + +[[sect-boost]] +== Boost 1.64 +The http://www.boost.org[Boost C++ libraries] have been upgraded to version 1.64. Apart from a number of bugfixes and improvements to existing libraries, this brings a new library compared to Fedora 26, Boost.Process. +For more information, see the http://www.boost.org/users/history/version_1_64_0.html[Boost 1.64 release notes]. + +[[sect-c-glibc]] +== GNU C Library 2.26 +Fedora 27 ships with version 2.26 of the GNU C Library (glibc). New features include: + +* A per-thread malloc cache has been added that significantly improves the malloc API family of functions on certain multithreaded workloads. +* Unicode 10.0.0 support for character encodings, character type info, and transliteration tables. +* Improvements in the DNS stub resolver including runtime detection of changed DNS servers (/etc/resolv.conf changes) and use of those new servers without needing to restart the process. + +Security improvements include fixes for the following vulnerabilities: CVE-2017-12132, CVE-2017-1000366, CVE-2010-3192, CVE-2017-12133. + +More information about this version of the GNU C Library can be found in https://sourceware.org/ml/libc-alpha/2017-08/msg00010.html[the release notes]. diff --git a/modules/release-notes/pages/developers/Development_D.adoc b/modules/release-notes/pages/developers/Development_D.adoc new file mode 100644 index 0000000..9d23197 --- /dev/null +++ b/modules/release-notes/pages/developers/Development_D.adoc @@ -0,0 +1,3 @@ +[[sect-d]] += D +include::{partialsdir}/entities.adoc[] diff --git a/modules/release-notes/pages/developers/Development_Go.adoc b/modules/release-notes/pages/developers/Development_Go.adoc new file mode 100644 index 0000000..f4029f0 --- /dev/null +++ b/modules/release-notes/pages/developers/Development_Go.adoc @@ -0,0 +1,11 @@ +[[sect-development-go]] += Go +include::{partialsdir}/entities.adoc[] + + +[#go-upgraded-to-1.9] +== Golang 1.9 + +Fedora 27 brings Golang 1.9, which includes performance improvements, bug fixes, and new features. Most notably, support for type aliasing, parallel compilation, and direct bit manipulation has been added. For a complete list of changes, see upstream change notes at link:https://tip.golang.org/doc/go1.9[https://tip.golang.org/doc/go1.9]. + +With this release, support for the ppc64 architecture has been left out from the Fedora Golang packages due to the fact that the ppc64 port of 'GC' is not feature-complete. diff --git a/modules/release-notes/pages/developers/Development_Haskell.adoc b/modules/release-notes/pages/developers/Development_Haskell.adoc new file mode 100644 index 0000000..c6139bc --- /dev/null +++ b/modules/release-notes/pages/developers/Development_Haskell.adoc @@ -0,0 +1,3 @@ +[[sect-haskell]] += Haskell +include::{partialsdir}/entities.adoc[] diff --git a/modules/release-notes/pages/developers/Development_Java.adoc b/modules/release-notes/pages/developers/Development_Java.adoc new file mode 100644 index 0000000..7ab9bd5 --- /dev/null +++ b/modules/release-notes/pages/developers/Development_Java.adoc @@ -0,0 +1,17 @@ +[[sect-java]] += Java +include::{partialsdir}/entities.adoc[] + +[[sect-java-java9]] +== Java 9 Technology Preview +Fedora 27 includes a technology preview of Java 9, offered through the `java-9-openjdk` and `java-9-openjdk-devel` and new `java-9-openjdk-jmod` packages. + +Java 8 remains the default JDK for this release. The inclusion of Java 9 / OpenJDK 9 will allow developers to develop and test their applications for the next version of Java in parallel while everyone can continue using the stable Java 8 for daily use. + +More information about the new features of OpenJDK 9 is available from http://openjdk.java.net/projects/jdk9/[the OpenJDK website]. + +[[sect-java-decouple]] +== System Java Setting Decoupled from Java Command Setting +In earlier versions of Fedora, Java applications installed from RPMs were run in the JVM that was found using the `PATH` environment variable. From this release, Java applications will be run using the default system JVM, which will be OpenJDK 8 in Fedora 27, without refering to `PATH`. Users will still be able to override the default by using the `JAVA_HOME` environment variable. + +More detail about this revised configuration can be found on the https://fedoraproject.org/wiki/Changes/Decouple_system_java_setting_from_java_command_setting[change page]. diff --git a/modules/release-notes/pages/developers/Development_Perl.adoc b/modules/release-notes/pages/developers/Development_Perl.adoc new file mode 100644 index 0000000..12b83ef --- /dev/null +++ b/modules/release-notes/pages/developers/Development_Perl.adoc @@ -0,0 +1,22 @@ +[[sect-perl]] += Perl +include::{partialsdir}/entities.adoc[] + +[[sect-perl-core]] +== Packaging of the Perl Core Modules +The release of Fedora 27 brings a change in the way that the Perl core modules are packaged by Fedora. In Perl, the core modules are the standard set of modules that ship with the Perl interpreter. Previously in Fedora, the Perl core modules were split into a number of subpackages in such a way that installing the `perl` package did not install the full set of Perl core modules. This behaviour was not what was expected by most Perl users and so, from Fedora 27, installing the `perl` package now installs the full set of Perl core modules. It is still possible to install only a minimal Perl interpreter by installing just the `perl-interpreter` package. + +[[sect-perl-526]] +== Perl 5.26 +A new version of perl is released every year and version 5.26 is 2017's stable release. This release includes three updates with widespread effects: + +."." no longer in @INC +For security reasons, the current directory (".") is no longer included by default at the end of the module search path (@INC). This may have widespread implications for the building, testing and installing of modules, and for the execution of scripts. + +.`do` may now warn +`do` now gives a deprecation warning when it fails to load a file which it would have loaded had "." been in @INC. + +.In regular expression patterns, a literal left brace "{" must be escaped +Unescaped literal { characters in regular expression patterns are no longer permitted. Use a pattern like "\{" or "[{]" to specify a match to a left brace. + +For more information about this release, please see the http://search.cpan.org/dist/perl-5.26.0/pod/perldelta.pod[5.26.0 perldelta] web page. diff --git a/modules/release-notes/pages/developers/Development_Python.adoc b/modules/release-notes/pages/developers/Development_Python.adoc new file mode 100644 index 0000000..6bedfaa --- /dev/null +++ b/modules/release-notes/pages/developers/Development_Python.adoc @@ -0,0 +1,7 @@ +[[sect-python]] += Python +include::{partialsdir}/entities.adoc[] + +[[sect-python-sudo-pip]] +== Making sudo pip Safe (Again) +The location where sudo pip3 installs modules has been changed to /usr/local/lib/pythonX.Y/site-packages, and sudo pip3 is henceforth safer to use. No other changes in user experience are expected. Sudo pip3 is not considered a standard way to install Python packages. Virtual environment and pip3 install --user should still be the prefered options. Additionally, Fedora will increase it's compliance with the Filesystem Hierarchy Standard, as user-installed host-specific Python modules will now be correctly located under /usr/local. diff --git a/modules/release-notes/pages/developers/Development_Ruby.adoc b/modules/release-notes/pages/developers/Development_Ruby.adoc new file mode 100644 index 0000000..7ce73f0 --- /dev/null +++ b/modules/release-notes/pages/developers/Development_Ruby.adoc @@ -0,0 +1,15 @@ +[[sect-ruby]] += Ruby +include::{partialsdir}/entities.adoc[] + +[[sect-ruby-rails]] +== Ruby on Rails 5.1 +Ruby on Rails has been updated to version 5.1 in Fedora 27. Some of the highlights in Rails 5.1 include: + +* Drop jQuery as a default dependency +* Yarn, Webpack and Capybara integration +* Encrypted secrets support +* Parameterized mailers support +* Virtual/generated column support for MySQL and MariaDB + +For more information, please see the http://guides.rubyonrails.org/v5.1/5_1_release_notes.html[Ruby on Rails 5.1 Release Notes]. diff --git a/modules/release-notes/pages/developers/Development_Tools.adoc b/modules/release-notes/pages/developers/Development_Tools.adoc new file mode 100644 index 0000000..fa1e740 --- /dev/null +++ b/modules/release-notes/pages/developers/Development_Tools.adoc @@ -0,0 +1,17 @@ +[[sect-development-tools]] += Development Tools +include::{partialsdir}/entities.adoc[] + +[[sect-development-tools-debuginfo]] +== Debuginfo Package Improvements +To observe what a program is doing, Fedora provides additional meta-data about code that is installed and runs on your system. These can be used together with tracers, profilers and debuggers to better understand what is running on your system (or to understand crashes or failures better). Previously, these debug info meta-data packages were fairly large, containing lots of information about multiple sub-packages together. With Fedora 27, these debug info meta-data packages have been split up into smaller sub-packages, making it possible to install just the debuginfo for one specific sub-package or library. The source files needed for debuggers (but not necessarily for tracers and profilers) have been separated out into their own debugsource package and it is now possible to install multiple, different versions or architectures of the debug info packages at the same time. For example, when trying to introspect a program installed in a container or virtual machine that is a different version of the package installed on the host, or when both a 32 bit and 64 bit version of a library is available. + +[[sect-development-tools-bodhi]] +== Bodhi Now Handles Non-RPM Artifacts +Bodhi, the https://bodhi.fedoraproject.org/[Fedora Updates System], can now handle more than just RPM files. If it can be tagged in https://koji.fedoraproject.org/koji/[Koji], it should be accepted by Bodhi. The release of Bodhi 3.0.0 enables: + +* Support for updating non-RPM artifacts, like modules. +* Support for complex package dependencies, which enables Fedora to start packaging Rust packages and allows Fedora to do a better job expressing valid ranges of supported dependency versions for existing packages. +* Support, via https://pagure.io/pungi[Pungi], for generating OSTrees that are more consistent with Fedora’s release day OSTrees. + +More information about this update to Bodhi can be found in the https://bodhi.fedoraproject.org/docs/release_notes.html[Bodhi 3.0.0 release notes] and the related https://fedoraproject.org/wiki/Changes/BodhiNonRPMArtifacts[Fedora change page]. diff --git a/modules/release-notes/pages/developers/Development_Web.adoc b/modules/release-notes/pages/developers/Development_Web.adoc new file mode 100644 index 0000000..56cc629 --- /dev/null +++ b/modules/release-notes/pages/developers/Development_Web.adoc @@ -0,0 +1,14 @@ +[[sect-web-development]] += Web Development +include::{partialsdir}/entities.adoc[] + +[[sect-web-development-node]] +== Node.js 8 +Fedora 27 includes Node.js 8, which is the current version of the platform. This release line will become a Node.js Long Term Support (LTS) release at the end of October 2017. Some of the highlights of Node.js 8 include: + +* http2 support +* experimental support for Node API (N-API) +* a significant update to the V8 JavaScript runtime that includes major improvements in performance and developer-facing APIs +* version 5 of the npm client + +For more information about the range of updates and new features introduced in Node.js 8, please see the https://medium.com/the-node-js-collection/node-js-8-big-improvements-for-the-debugging-and-native-module-ecosystem-58454861f2fc[release announcement]. diff --git a/modules/release-notes/pages/index.adoc b/modules/release-notes/pages/index.adoc new file mode 100644 index 0000000..602d52e --- /dev/null +++ b/modules/release-notes/pages/index.adoc @@ -0,0 +1,14 @@ += Release Notes +include::{partialsdir}/entities.adoc[] + +Release Notes for Fedora {PRODVER} + +[abstract] +-- +This document provides the release notes for Fedora {PRODVER}. It describes major changes offered as compared to Fedora {PREVVER}. +-- + +image:title_logo.svg[Fedora Logo] +include::{partialsdir}/Legal_Notice.adoc[] + +include::{partialsdir}/Author_Group.adoc[] diff --git a/modules/release-notes/pages/sysadmin/ARM_Architectures.adoc b/modules/release-notes/pages/sysadmin/ARM_Architectures.adoc new file mode 100644 index 0000000..2eccbb6 --- /dev/null +++ b/modules/release-notes/pages/sysadmin/ARM_Architectures.adoc @@ -0,0 +1,9 @@ +[[sect-ARM]] += ARM Architectures +include::{partialsdir}/entities.adoc[] + +[[sect-ARM-aarch64]] +== aarch64 Single Board Computer Disk Images +Fedora now includes disk images for 64 bit ARM (aarch64) Single Board Computer (SBC) devices, for example the Pine64 or Raspberry Pi 3. In the same manner as for the ARMv7 SBC images, there will be a single disk image for each of Fedora's Minimal, Server and Workstation Editions that will cover all supported devices. + +More information about Fedora on ARM and the supported devices can be found on the https://fedoraproject.org/wiki/Architectures/ARM[ARM Architecture page]. diff --git a/modules/release-notes/pages/sysadmin/Domain_Controllers.adoc b/modules/release-notes/pages/sysadmin/Domain_Controllers.adoc new file mode 100644 index 0000000..0fb7c75 --- /dev/null +++ b/modules/release-notes/pages/sysadmin/Domain_Controllers.adoc @@ -0,0 +1,49 @@ +[[sect-domain-controllers]] += Domain Controllers +include::{partialsdir}/entities.adoc[] + +[[sect-domain-controllers-samba-changes]] +== Samba changes + +Samba project completed conversion of Samba AD DC to support MIT Kerberos. Fedora 27 is the first Fedora version to include Samba AD domain controller functionality. + +The Samba AD process will take care of starting the MIT KDC and it will load a KDB (Kerberos Database) driver to access the Samba AD database. When +provisioning an AD DC using 'samba-tool' it will take care of creating a correct kdc.conf file for the MIT KDC. + +For further details, see: link:++https://wiki.samba.org/index.php/Running_a_Samba_AD_DC_with_MIT_Kerberos_KDC++[upstream's documentation]. + +Important changes to note: + +* Two different deployment modes are now supported for Samba domain controller: + - Traditional domain controller (NT-style domain controller) + - Active Directory domain controller (new mode). +* Samba upgraded to version 4.7. +* The default for `client max protocol` has changed to `SMB3_11`, which means that `smbclient` (and related commands) will work against servers without SMB1 support. It is possible to use the `m/--max-protocol` option to overwrite the `client max protocol` option temporarily. +* Encryption support in `smbclient` (option `-e/--encrypt`) works with SMB3 servers as well (Windows Server 2012 or later, Samba 4.0.0 or later). +* The change to `SMB3_11` as default also means `smbclient` no longer negotiates `SMB1` unix extensions by default, when talking to a Samba server with `unix extensions = yes`. As a result, some commands are not available, e.g. `posix_encrypt`, `posix_open`, `posix_mkdir`, `posix_rmdir`, `posix_unlink`, `posix_whoami`, `getfacl` and `symlink`. Using `-mNT1` reenables them, if the server supports SMB1. +* `smbclient` learned a new command 'deltree' that is able to do a recursive deletion of a directory tree. +* The dynamic port range for RPC services has been changed from the old default value `1024-1300` to `49152-65535`. This port range is not only used by a Samba AD DC, but also applies to all other server roles including NT4-style domain controllers. The new value has been defined by Microsoft in Windows Server 2008 and newer versions. To make it easier for Administrators to control those port ranges we use the same default and make it configurable with the option: `rpc server dynamic port range`. The `rpc server port` option sets the first available port from the new `rpc server dynamic port range` option. The option `rpc server port` only applies to Samba provisioned as an AD DC. + +Samba AD DC with MIT Kerberos does not have all the features of Heimdal Kerberos build. Missing features, compared to a Heimdal Kerberos build, are: + +* PKINIT support +* S4U2SELF/S4U2PROXY support +* Read-only domain controller support (RODC). This functionality is not fully working with Heimdal Kerberos build either. + + +[[sect-domain-controllers-freeipa-changes]] +== FreeIPA changes + +FreeIPA has been upgraded to version 4.6. This is a major FreeIPA release which supports Python 3. + +Major changes compared to FreeIPA 4.4 which was shipped in Fedora 26: + +* FreeIPA is using Python 3 now +* Security defaults are in line with the rest of Fedora. In particular, newly issued certificates default to SHA-256. +* Smartcard support was added to FreeIPA and SSSD. New `ipa-advise` recipes are available to configure FreeIPA-enrolled clients and servers to support smartcard authentication. +* FreeIPA web UI can now be accessed using smartcard authentication. This feature is not enabled by default. +* Kerberos PKINIT is enabled by default on new installations with an integrated Certificate Authority. This allows to use smartcards to login to FreeIPA-enrolled hosts and obtain Kerberos tickets. +* Kerberos authentication indicator `pkinit` is automatically issued when Kerberos PKINIT pre-authentication succeeds. As result, elevated security requirements can be assigned to Kerberos services that require to only smartcard (`pkinit`), multi-factor (`otp`), or RADIUS (`radius`) authentication to succeed prior accessing them. +* Users from trusted Active Directory domains can now login to FreeIPA web UI and perform self-service operations. +* FreeIPA can now be installed in an environment subject to FIPS 140-2 requirements. + diff --git a/modules/release-notes/pages/sysadmin/Installation.adoc b/modules/release-notes/pages/sysadmin/Installation.adoc new file mode 100644 index 0000000..3c16a23 --- /dev/null +++ b/modules/release-notes/pages/sysadmin/Installation.adoc @@ -0,0 +1,7 @@ +[[sect-installation]] += Installation +include::{partialsdir}/entities.adoc[] + +[[sect-installation-trim]] +== TRIM pass down to encrypted disks +With this change Fedora becomes more friendly to SSD drives. During the installation procedure, any newly created storage with LUKS encryption (newly formatted encrypted partitions, logical volumes, and so on) is configured to use the `discard` option which enables https://en.wikipedia.org/wiki/Trim_(computing)[TRIM]. This potentially increases the lifetime of SSD drives while **not** affecting encrypted data security and it has no effect on HDDs. diff --git a/modules/release-notes/pages/sysadmin/Kernel.adoc b/modules/release-notes/pages/sysadmin/Kernel.adoc new file mode 100644 index 0000000..91a129e --- /dev/null +++ b/modules/release-notes/pages/sysadmin/Kernel.adoc @@ -0,0 +1,3 @@ +[[sect-kernel]] += Kernel +include::{partialsdir}/entities.adoc[] diff --git a/modules/release-notes/pages/sysadmin/Mail_Servers.adoc b/modules/release-notes/pages/sysadmin/Mail_Servers.adoc new file mode 100644 index 0000000..7281c16 --- /dev/null +++ b/modules/release-notes/pages/sysadmin/Mail_Servers.adoc @@ -0,0 +1,3 @@ +[[sect-mail-servers]] += Mail Servers +include::{partialsdir}/entities.adoc[] diff --git a/modules/release-notes/pages/sysadmin/Modularity.adoc b/modules/release-notes/pages/sysadmin/Modularity.adoc new file mode 100644 index 0000000..ec47836 --- /dev/null +++ b/modules/release-notes/pages/sysadmin/Modularity.adoc @@ -0,0 +1,21 @@ +[[sect-modularity]] += Fedora Modularity +include::{partialsdir}/entities.adoc[] + +Modularity is the initiative to disconnect the lifecycle of applications from each other and from the lifecycle of the operating system, while still maintaining the ease of use of a typical Linux distribution. This work has produced two changes that have been incorporated into Fedora 27: Host and Platform and Modular Server. + +[[sect-modularity-host-platform]] +== Host and Platform +The Host and Platform change is an evolution of the Base Runtime module concept that was introduced in the Fedora 26 Boltron Release, splitting the minimal system further into independent modules, which gives greater flexibility when composing and maintaining the base system. + +* The Host module delivers hardware enablement components such as the kernel, bootloaders, firmware, possibly additional device drivers and other components closely linked to these. + +* The Platform module defines the operating system release and includes various base userspace components ranging from the C library and init system to system management & deployment tools, container runtime and possibly several services that are commonly considered to be part of the base system experience. + +The Host and Platform modules are independent, making it possible to run the same Host with different Platforms and vice versa. Each of the two modules has its own life cycle, update cadence and versioning scheme. + +[[sect-modularity-modular-server]] +== Modular Server +The Modular Server change promotes the work done in the Fedora 26 Boltron Release to the Fedora Server Edition. In Fedora 27, the Fedora Server Edition is created and delivered using the Modularity infrastructure pipeline and the Host and Platform design concept. + +Other Fedora Editions and Spins will not change in this release; users who want to use Fedora to create a server (as opposed to capital-S Fedora Server) without Modularity can use one of the other editions, for example the Fedora Cloud Base Image, or the "Everything" network installer. diff --git a/modules/release-notes/pages/sysadmin/Packaging.adoc b/modules/release-notes/pages/sysadmin/Packaging.adoc new file mode 100644 index 0000000..a778e6f --- /dev/null +++ b/modules/release-notes/pages/sysadmin/Packaging.adoc @@ -0,0 +1,15 @@ +[[sect-packaging]] += Packaging +include::{partialsdir}/entities.adoc[] + +[[sect-packaging-rpm]] +== RPM 4.14 +This Fedora release contains RPM 4.14. Users' general experience of RPM will benefit from the bugfixes and from the better handling of invalid data. Packagers can take advantage of: + + * Better error reporting by the macro engine + * Dependency generators now properly support rich (boolean) dependencies + * New `with`, `without` and `unless` rich operators + +The maximum supported header size has been significantly raised in RPM 4.14. This cannot be tracked with `rpmlib()` dependencies as that would require accessing the header, so attempting to access packages with a header larger than 32MB will cause an abrupt failure with ALL older RPM versions. + +For more information please see the http://rpm.org/wiki/Releases/4.14.0[RPM 4.14 Release Notes]. diff --git a/modules/release-notes/pages/sysadmin/Security.adoc b/modules/release-notes/pages/sysadmin/Security.adoc new file mode 100644 index 0000000..84e5b91 --- /dev/null +++ b/modules/release-notes/pages/sysadmin/Security.adoc @@ -0,0 +1,47 @@ +[[sect-security]] += Security +include::{partialsdir}/entities.adoc[] + +[[sect-security-kerberos-kcm]] +== Kerberos KCM credential cache by default +Fedora 27 defaults to a new Kerberos credential cache type called Kerberos Cache Manager (KCM), implemented in the sssd-kcm service, that is better suited for containerized environments and also provides a better user experience in the general case. Key features of KCM include: + +* Kerberos credential caches are handled by a userspace deamon with a UNIX socket entry point. That means the UIDs and GIDs of the cache owners are subject to UID namespacing, which is beneficial in containerized environments. +* The UNIX socket can be mounted into containers on demand, thus allowing one or more containers to share a single Kerberos credential cache. +* The KCM deamon is stateful. While no functionality that benefits from that is implemented in F-27, the deamon will allow automatic refreshes of a user's Kerberos credentials if needed. + +Information about using KCM can be found in `man sssd-kcm` and also in `man sssd-secrets`, because KCM uses sssd-secrets for data storage. Additional information is contained in the https://docs.pagure.org/SSSD.sssd/design_pages/kcm.html[SSSD Design Page for KCM]. + +[[sect-security-krb5-appl]] +== krb5-appl Packages Removed +The `krb5-appl-clients` and `krb5-appl-servers` packages are considered to be obsolete and have been removed from Fedora. These packages provided Kerberos-aware telnet, ftp, rcp, rsh, and rlogin clients and servers. Users should to move to more modern security tools, such as openssh. + + +[#sect-defauilt-ciopher-in-openvpn-changed-to-256-bit-aes-gcm] +== Default cipher in OpenVPN changed to 256-bit AES-GCM + +OpenVPN configurations utilizing the newer `openvpn-server@.service` unit file now use a stronger cipher for the VPN tunnel by default. The default is changed from the Blowfish algorithm using 128-bit keys to the newer AES-GCM algorithm with 256-bit keys. + +To ensure backwards compatibility, this new default also enables clients still using the not recommended Blowfish algorithm to connect by utilizing the `--ncp-ciphers` feature being available in OpenVPN{nbsp}2.4. + +To facilitate an easy migration path away from Blowfish for clients not supporting AES-GCM, these clients can now add or change the `--cipher` option in the client configuration to either `AES-256-CBC` or `AES-128-CBC` without needing to do any other server changes. + + +[#sect-openshh-server-now-follows-system-wide-crypto-policies] +== OpenSSH Server now follows system-wide crypto policies + +Fedora defines system-wide crypto policies, which are followed by cryptographic libraries and tools, including OpenSSH clients. This allows administrators to use different system-wide security levels. With this update, OpenSSH Server adheres to these system-wide crypto policies, too. + +This modification adds environment variables that specify enabled algorithms. The information is passed to the `sshd` daemon on the command line. It is, therefore, necessary to restart the `sshd` service for changes to crypto-policy configuration to take effect. + + +[#sect-ssh-1-support-removed-from-openssh] +== SSH-1 support removed from OpenSSH + +The SSH-1 protocol is obsolete and no longer considered secure. As such, it is not supported by the default OpenSSH client binaries packaged for Fedora. This changes removes support for the SSH-1 protocol altogether by removing the *openssh-clients-ssh1* subpackage. + + +[#sect-libcurl-switches-to-using-openssl] +== libcurl switches to using OpenSSL + +The *libcurl* library now uses OpenSSL for TLS and crypto (instead of NSS). TLS certificates and keys stored in the NSS database need to be exported to files for *libcurl* to be able to load them. See link:http://pki.fedoraproject.org/wiki/NSS_Database[http://pki.fedoraproject.org/wiki/NSS_Database] for instructions on how to work with the NSS database. diff --git a/modules/release-notes/pages/sysadmin/Xorg.adoc b/modules/release-notes/pages/sysadmin/Xorg.adoc new file mode 100644 index 0000000..ba2118f --- /dev/null +++ b/modules/release-notes/pages/sysadmin/Xorg.adoc @@ -0,0 +1,3 @@ +[[sect-x-org]] += X.Org +include::{partialsdir}/entities.adoc[] diff --git a/modules/release-notes/pages/welcome/Feedback.adoc b/modules/release-notes/pages/welcome/Feedback.adoc new file mode 100644 index 0000000..1a1b3e7 --- /dev/null +++ b/modules/release-notes/pages/welcome/Feedback.adoc @@ -0,0 +1,19 @@ +[[sect-Release_Notes-Feedback]] += Feedback +include::{partialsdir}/entities.adoc[] + +Thank you for taking the time to provide your comments, suggestions, and bug reports to the Fedora community; this helps improve the state of Fedora, Linux, and free software worldwide. + +== Providing Feedback on Fedora Software + +To provide feedback on Fedora software or other system elements, please refer to link:++http://fedoraproject.org/wiki/BugsAndFeatureRequests++[Bugs And Feature Requests]. A list of commonly reported bugs and known issues for this release is available from link:{COMMONBUGS_URL}[Common F26 Bugs] on the wiki. + +== Providing Feedback on Release Notes + +If you feel these release notes could be improved in any way, you can provide your feedback directly to the beat writers. There are several ways to provide feedback, in order of preference: + +* If you have a Fedora account, edit content directly at link:++http://fedoraproject.org/wiki/Docs/Beats++[Docs-Beats] page on the wiki. + +* Fill out a bug request using link:{BZURL}[http://pagure.io/] - *This link is ONLY for feedback on the release notes themselves.* Refer to the admonition above for details. + +* E-mail the Release-Note mailing list at link:mailto:relnotes@fedoraproject.org[relnotes@fedoraproject.org]. diff --git a/modules/release-notes/pages/welcome/Hardware_Overview.adoc b/modules/release-notes/pages/welcome/Hardware_Overview.adoc new file mode 100644 index 0000000..c02d463 --- /dev/null +++ b/modules/release-notes/pages/welcome/Hardware_Overview.adoc @@ -0,0 +1,77 @@ +[[sect-hardware-overview]] += Hardware Overview +include::{partialsdir}/entities.adoc[] + +Fedora {PRODVER} provides software to suit a wide variety of applications. The storage, memory and processing requirements vary depending on usage. For example, a high traffic database server requires much more memory and storage than a business desktop, which in turn has higher requirements than a single-purpose virtual machine. + +[[hardware_overview-specs]] +== Minimum System Configuration + +The figures below are a recommended minimum for the default installation. Your requirements may differ, and most applications will benefit from more than the minimum resources. + +* 1GHz or faster processor + +* 1GB System Memory + +* 10GB unallocated drive space + +.Low memory installations +[NOTE] +==== +Fedora {PRODVER} can be installed and used on systems with limited resources for some applications. Text, VNC, or kickstart installations are advised over graphical installation for systems with very low memory. Larger package sets require more memory during installation, so users with less than 768MB of system memory may have better results preforming a minimal install and adding to it afterward. + +For best results on systems with less than 1GB of memory, use the DVD installation image. +==== + +[[hardware_overview-resolution]] +== Display resolution + +.Graphical Installation requires 800x600 resolution or higher +[NOTE] +==== +Graphical installation of Fedora requires a minimum screen resolution of 800x600. Owners of devices with lower resolution, such as some netbooks, should use text or VNC installation. + +Once installed, Fedora will support these lower resolution devices. The minimum resolution requirement applies only to graphical installation. +==== + +[[hardware_overview-graphics]] +== Graphics Hardware + +[[hardware_overview-graphics-legacy_gpus]] +=== Minimum Hardware for Accelerated Desktops + +Fedora {PRODVER} supports most display adapters. Modern, feature-rich desktop environments like *GNOME3* and *KDE Plasma Workspaces* use video devices to provide 3D-accelerated desktops. Older graphics hardware may *not support* acceleration: + +* Intel prior to GMA9xx + +* NVIDIA prior to NV30 (GeForce FX5xxx series) + +* Radeon prior to R300 (Radeon 9500) + +[[hardware_overview-graphics-cpu_acceleration]] +=== CPU Accelerated Graphics + +Systems with older or no graphics acceleration devices can have accelerated desktop environments using *LLVMpipe* technology, which uses the CPU to render graphics. *LLVMpipe* requires a processor with `SSE2` extensions. The extensions supported by your processor are listed in the `flags:` section of `/proc/cpuinfo` + +[[hardware_overview-graphics-desktops]] +=== Choosing a Desktop Environment for your hardware + +Fedora {PRODVER}'s default desktop environment, *GNOME3*, functions best with hardware acceleration. Alternative desktops are recommended for users with older graphics hardware or those seeing insufficient performance with *LLVMpipe*. + +Desktop environments can be added to an existing installation and selected at login. To list the available desktops, use the [command]`dnf grouplist` command: + +---- +# dnf grouplist -v hidden | grep desktop +---- + +Install the desired group: + +---- +# dnf groupinstall "KDE Plasma Workspaces" +---- + +Or, use the short group name to install: + +---- +# dnf install @mate-desktop-environment +---- diff --git a/modules/release-notes/pages/welcome/Overview.adoc b/modules/release-notes/pages/welcome/Overview.adoc new file mode 100644 index 0000000..27b74fb --- /dev/null +++ b/modules/release-notes/pages/welcome/Overview.adoc @@ -0,0 +1,7 @@ +[[sect-overview]] += Overview +include::{partialsdir}/entities.adoc[] + +As always, Fedora continues to develop and integrate the latest free and open source software. The following sections provide a brief overview of major changes from the last release of Fedora. + +More detailed information about changes in this release can be found on the link:https://fedoraproject.org/wiki/Releases/{PRODVER}/ChangeSet[Fedora Project Wiki]. diff --git a/modules/release-notes/pages/welcome/Welcome.adoc b/modules/release-notes/pages/welcome/Welcome.adoc new file mode 100644 index 0000000..681dcee --- /dev/null +++ b/modules/release-notes/pages/welcome/Welcome.adoc @@ -0,0 +1,37 @@ +[[sect-welcome_to_fedora]] += Welcome to Fedora +include::{partialsdir}/entities.adoc[] + +The Fedora Project is a partnership of Free software community members from around the globe. The Fedora Project builds open source software communities and produces a Linux distribution called Fedora. + +The Fedora Project's mission is to lead the advancement of Free and open source software and content as a collaborative community. The three elements of this mission are clear: + +* The Fedora Project always strives to lead, not follow. + +* The Fedora Project consistently seeks to create, improve, and spread Free/Libre code and content. + +* The Fedora Project succeeds through shared action on the part of many people throughout our community. + +To find out more general information about Fedora, refer to the following pages, on the Fedora Project Wiki: + +* link:++http://fedoraproject.org/wiki/Overview++[Fedora Overview] + +* link:++http://fedoraproject.org/wiki/FAQ++[Fedora FAQ] + +* link:++http://fedoraproject.org/wiki/Communicate++[Help and Discussions] + +* link:++http://fedoraproject.org/wiki/Join++[Participate in the Fedora Project] + +[[sect-need-help]] +== Need Help? + +There are a number of places you can get assistance should you run into problems. + +If you run into a problem and would like some assistance, go to link:++http://ask.fedoraproject.org++[]. Many answers are already there, but if you don't find yours, you can simply post a new question. This has the advantage that anyone else with the same problem can find the answer, too. + +You may also find assistance on the `#fedora` channel on the IRC net `irc.freenode.net`. Keep in mind that the channel is populated by volunteers wanting to help, but folks knowledgeable about a specific topic might not always be available. + +[[sect-providing-help]] +== Want to Contribute? + +You can help the Fedora Project community continue to improve Fedora if you file bug reports and enhancement requests. Refer to link:++http://fedoraproject.org/wiki/BugsAndFeatureRequests++[Bugs And Feature Requests] on the Fedora Wiki for more information about bug and feature reporting. Thank you for your participation. diff --git a/preview.sh b/preview.sh new file mode 100755 index 0000000..acab783 --- /dev/null +++ b/preview.sh @@ -0,0 +1,18 @@ +#!/bin/sh + +if [ "$(uname)" == "Darwin" ]; then + # Running on macOS. + # Let's assume that the user has the Docker CE installed + # which doesn't require a root password. + echo "The preview will be available at http://localhost:8080/" + docker run --rm -v $(pwd)/public:/usr/share/nginx/html:ro -p 8080:80 nginx + +elif [ "$(expr substr $(uname -s) 1 5)" == "Linux" ]; then + # Running on Linux. + # Let's assume that it's running the Docker deamon + # which requires root. + echo "" + echo "This build script is using Docker to run the build in an isolated environment. You might be asked for a root password in order to start it." + echo "The preview will be available at http://localhost:8080/" + sudo docker run --rm -v $(pwd)/public:/usr/share/nginx/html:ro -p 8080:80 nginx +fi diff --git a/site.yml b/site.yml new file mode 100644 index 0000000..4a3f504 --- /dev/null +++ b/site.yml @@ -0,0 +1,22 @@ +site: + title: Local Preview + start_page: fedora:release-notes:index +content: + sources: + - url: https://pagure.io/forks/bex/fedora-docs/docs-fp-o.git + branches: antora_f27 + - url: . + branches: HEAD +ui: + bundle: + url: https://asamalik.fedorapeople.org/ui-bundle.zip + snapshot: true + default_layout: with_menu +output: + clean: true + dir: ./public + destinations: + - provider: archive +runtime: + pull: true + cache_dir: ./cache From 34621ca8085e078dab82fee3811a7d18df91304d Mon Sep 17 00:00:00 2001 From: Brian (bex) Exelbierd Date: Jul 28 2018 11:15:11 +0000 Subject: [PATCH 2/3] make nav better for shared display --- diff --git a/modules/release-notes/nav.adoc b/modules/release-notes/nav.adoc index 2669532..ffdebd3 100644 --- a/modules/release-notes/nav.adoc +++ b/modules/release-notes/nav.adoc @@ -1,24 +1,23 @@ -* xref:index.adoc[Book Information] -* Welcome to Fedora +* xref:index.adoc[Fedora Release Notes] ** xref:welcome/Welcome.adoc[Welcome to Fedora] -** xref:welcome/Overview.adoc[Overview] -** xref:welcome/Hardware_Overview.adoc[Hardware Overview] -** xref:welcome/Feedback.adoc[Feedback] -* Changes in Fedora for System Administrators -** xref:sysadmin/Modularity.adoc[Fedora Modularity] -** xref:sysadmin/Installation.adoc[Installation] -** xref:sysadmin/Security.adoc[Security] -** xref:sysadmin/Domain_Controllers.adoc[Domain Controllers] -** xref:sysadmin/ARM_Architectures.adoc[ARM Architectures] -** xref:sysadmin/Packaging.adoc[Packaging] -* Changes in Fedora for Desktop Users -** xref:desktop/Desktop.adoc[Desktop] -* Changes in Fedora for Developers -** xref:developers/Development_Tools.adoc[Development Tools] -** xref:developers/Development_C.adoc[C and C++] -** xref:developers/Development_Go.adoc[Go] -** xref:developers/Development_Java.adoc[Java] -** xref:developers/Development_Perl.adoc[Perl] -** xref:developers/Development_Python.adoc[Python] -** xref:developers/Development_Ruby.adoc[Ruby] -** xref:developers/Development_Web.adoc[Web Development] +*** xref:welcome/Overview.adoc[Overview] +*** xref:welcome/Hardware_Overview.adoc[Hardware Overview] +*** xref:welcome/Feedback.adoc[Feedback] +** Changes in Fedora for System Administrators +*** xref:sysadmin/Modularity.adoc[Fedora Modularity] +*** xref:sysadmin/Installation.adoc[Installation] +*** xref:sysadmin/Security.adoc[Security] +*** xref:sysadmin/Domain_Controllers.adoc[Domain Controllers] +*** xref:sysadmin/ARM_Architectures.adoc[ARM Architectures] +*** xref:sysadmin/Packaging.adoc[Packaging] +** Changes in Fedora for Desktop Users +*** xref:desktop/Desktop.adoc[Desktop] +** Changes in Fedora for Developers +*** xref:developers/Development_Tools.adoc[Development Tools] +*** xref:developers/Development_C.adoc[C and C++] +*** xref:developers/Development_Go.adoc[Go] +*** xref:developers/Development_Java.adoc[Java] +*** xref:developers/Development_Perl.adoc[Perl] +*** xref:developers/Development_Python.adoc[Python] +*** xref:developers/Development_Ruby.adoc[Ruby] +*** xref:developers/Development_Web.adoc[Web Development] From 8d923c7be83fd56d840d400c4f2352c45926cfc8 Mon Sep 17 00:00:00 2001 From: Adam Samalik Date: Jul 28 2018 12:50:53 +0000 Subject: [PATCH 3/3] add readme --- diff --git a/README.md b/README.md new file mode 100644 index 0000000..82ad1f6 --- /dev/null +++ b/README.md @@ -0,0 +1,43 @@ +# Fedora Modularity Docs + +Please report Issues and submit Pull Requests for **Content Fixes** here. +Never done a pull request (or "PR")? Here's the [Pagure documentation for +Pull Requests](https://docs.pagure.org/pagure/usage/pull_requests.html). + + +General appearance issues and publishing issues should be reported against +the [publishing software](https://pagure.io/fedora-docs/docs-fp-o). + +## How to edit these documents + +All of this is written in AsciiDoc. It's a simple mostly-plain-text +markup language. You may want to look at: + + +* [AsciiDoc Syntax Quick Reference](http://asciidoctor.org/docs/asciidoc-syntax-quick-reference/) +* [AsciiDoc Writer’s Guide](http://asciidoctor.org/docs/asciidoc-writers-guide/) +* [Antora Documentation](https://docs.antora.org/antora/1.0/page/) + + +## Local preview + +This repo includes scripts to build and preview the contents of this repository. + +**NOTE**: Please note that if you reference pages from other repositoreis, such links will be broken in this local preview as it only builds this repository. If you want to rebuild the whole Fedora Docs site, please see [the Fedora Docs build repository](https://pagure.io/fedora-docs/docs-fp-o/) for instructions. + +Both scripts use docker, so please make sure you have it installed on your system. Please see below for instructions. + +To build and preview the site, run: + +``` +$ ./build.sh && ./preview.sh +``` + +The result will be available at http://localhost:8080 + +### Installing docker on Fedora + +``` +$ sudo dnf install docker +$ sudo systemctl start docker && sudo systemctl enable docker +```