PR#798: nav: group programming languages in navbar - packaging-committee

packaging-committee

#798 nav: group programming languages in navbar

Closed 5 years ago by tibbs. Opened 5 years ago by ignatenkobrain.

ignatenkobrain/packaging-committee nav into master

nav: group programming languages in navbar

Igor Gnatenko • 5 years ago

8a5f6b0

guidelines/modules/ROOT/nav.adoc

file modified

+19 -18

		`@@ -1,13 +1,29 @@`
		`- * xref:Ada.adoc[Ada]`
		`+ * xref:programming-languages.adoc[Programming Languages]`
		`+ ** xref:Ada.adoc[Ada]`
		`+ ** xref:C_and_C++.adoc[C and {cpp}]`
		`+ ** xref:D.adoc[D]`
		`+ ** xref:Fortran.adoc[Fortran]`
		`+ ** xref:Haskell.adoc[Haskell]`
		`+ ** xref:Java.adoc[Java]`
		`+ ** xref:JavaScript.adoc[JavaScript]`
		`+ ** xref:Lisp.adoc[Lisp]`
		`+ ** xref:Mono.adoc[Mono]`
		`+ ** xref:Node.js.adoc[Node.js]`
		`+ ** xref:OCaml.adoc[OCaml]`
		`+ ** xref:Octave.adoc[Octave]`
		`+ ** xref:Perl.adoc[Perl]`
		`+ ** xref:PHP.adoc[PHP]`
		`+ ** xref:Python.adoc[Python]`
		`+ ** xref:R.adoc[R]`
		`+ ** xref:Ruby.adoc[Ruby]`
		`+ ** xref:Rust.adoc[Rust]`
		`* xref:Alternatives.adoc[Alternatives]`
		`* xref:AppData.adoc[AppData]`
		`* xref:AutoProvidesAndRequiresFiltering.adoc[AutoProvidesAndRequiresFiltering]`
		`- * xref:C_and_C++.adoc[C and {cpp}]`
		`* xref:CMake.adoc[CMake]`
		`* xref:Conflicts.adoc[Conflicts]`
		`* xref:CronFiles.adoc[CronFiles]`
		`* xref:CryptoPolicies.adoc[CryptoPolicies]`
		`- * xref:D.adoc[D]`
		`* xref:Debuginfo.adoc[Debuginfo]`
		`* xref:DefaultServices.adoc[DefaultServices]`
		`* xref:deprecating-packages.adoc[Deprecating Packages]`
		`@@ -20,43 +36,28 @@`
		`* xref:EnvironmentModules.adoc[EnvironmentModules]`
		`* https://fedoraproject.org/wiki/EPEL:Packaging[EPEL]`
		`* xref:FontsPolicy.adoc[Fonts]`
		`- * xref:Fortran.adoc[Fortran]`
		`* xref:FullExceptionList.adoc[FullExceptionList]`
		`* xref:GAP.adoc[GAP]`
		`* xref:GCJGuidelines.adoc[GCJGuidelines]`
		`* xref:Globus.adoc[Globus Toolkit]`
		`- * xref:Haskell.adoc[Haskell]`
		`* xref:Initial_Service_Setup.adoc[Initial_Service_Setup]`
		`- * xref:Java.adoc[Java]`
		`- * xref:JavaScript.adoc[JavaScript]`
		`* xref:KernelModules.adoc[KernelModules]`
		`* xref:Langpacks.adoc[Language packs]`
		`* xref:LibreOfficeExtensions.adoc[LibreOffice Extensions]`
		`* xref:LicensingGuidelines.adoc[Licensing]`
		`- * xref:Lisp.adoc[Lisp]`
		`* xref:Meson.adoc[Meson]`
		`* xref:MinGW.adoc[MinGW]`
		`- * xref:Mono.adoc[Mono]`
		`* xref:MPI.adoc[MPI]`
		`* xref:Naming.adoc[Naming]`
		`- * xref:Node.js.adoc[Node.js]`
		`- * xref:OCaml.adoc[OCaml]`
		`- * xref:Octave.adoc[Octave]`
		`* xref:PatchUpstreamStatus.adoc[PatchUpstreamStatus]`
		`- * xref:Perl.adoc[Perl]`
		`* xref:Per-Product_Configuration.adoc[Per-Product_Configuration]`
		`- * xref:PHP.adoc[PHP]`
		`* xref:PkgConfigBuildRequires.adoc[PkgConfigBuildRequires]`
		`* xref:PreupgradeAssistant.adoc[Preupgrade Assistant]`
		`- * xref:Python.adoc[Python]`
		`* xref:Python_Appendix.adoc[Python_Appendix]`
		`* xref:Python_Eggs.adoc[Python_Eggs]`
		`- * xref:R.adoc[R]`
		`* xref:ReviewGuidelines.adoc[ReviewGuidelines]`
		`* xref:RPMMacros.adoc[RPMMacros]`
		`* xref:RPM_Source_Dir.adoc[RPM_Source_Dir]`
		`- * xref:Ruby.adoc[Ruby]`
		`- * xref:Rust.adoc[Rust]`
		`* xref:Scriptlets.adoc[Scriptlets]`
		`* xref:SourceURL.adoc[SourceURL]`
		`* xref:SSLCertificateHandling.adoc[SSLCertificateHandling]`

guidelines/modules/ROOT/pages/programming-languages.adoc

file added

		`@@ -0,0 +1,4 @@`
		`+ = Programming Languages`
		`+`
		`+ Many programming languages have their own packaging guidelines.`
		`+ You can find links to these in the navigation bar.`

ignatenkobrain commented 5 years ago

Signed-off-by: Igor Gnatenko ignatenkobrain@fedoraproject.org

tibbs commented on line 4 of guidelines/modules/ROOT/pages/programming-languages.adoc 5 years ago

This isn't actually true. I suggest:

"Many programming languages have their own packaging guidelines. You can find links to these in the navigation bar."

As an aside, the PR method means that if I just want to fix this myself, I would have to merge and then edit afterwards. Which I guess I can just do.

rebased onto 07bf275733e9da65fc38e397024270eb7a689c8a

5 years ago

ignatenkobrain commented 5 years ago

@tibbs looks better now?

rebased onto 8a5f6b0

5 years ago

tibbs commented 5 years ago

I went ahead and did something similar. I didn't see a need for a guideline page with three pages in it, and I don't believe that there's any requirement for navbar entries to all be links, so I just left the "programming languages" page out completely. I also nested the two Python subdocuments under Python itself.

Hopefully this will look correct when the main page is updated.