diff --git a/docs/index.md b/docs/index.md index 514d8ee..b875fa5 100644 --- a/docs/index.md +++ b/docs/index.md @@ -32,11 +32,12 @@ Outside of these guidelines, package contributions should always be welcome! ## Links -- **SIG-FastTrack Wiki: ** https://sig-fasttrack.rocky.page/ -- **MatterMost Channel: ** https://chat.rockylinux.org/rocky-linux/channels/sig-fasttrack -- **FastTrack Git Group: ** https://git.resf.org/sig_fasttrack/ (New package requests can be in meta/, wiki source under wiki/ ) -- **FastTrack Package Sources: ** https://git.rockylinux.org/sig/fasttrack/ -- +- **SIG-FastTrack Wiki:** [https://sig-fasttrack.rocky.page/](https://sig-fasttrack.rocky.page/) +- **MatterMost Chat Channel:** [https://chat.rockylinux.org/rocky-linux/channels/sig-fasttrack](https://chat.rockylinux.org/rocky-linux/channels/sig-fasttrack) +- **FastTrack Git Group:** [https://git.resf.org/sig_fasttrack/](https://git.resf.org/sig_fasttrack/) (New package requests can be in meta/, wiki source under wiki/ ) +- **FastTrack Package Sources:** [https://git.rockylinux.org/sig/fasttrack/](https://git.rockylinux.org/sig/fasttrack/) +- **Peridot RPM Build System:** [https://peridot.build.resf.org/](https://peridot.build.resf.org/) + ## Responsibilities diff --git a/docs/package_list/index.md b/docs/package_list/index.md new file mode 100644 index 0000000..4c3e41f --- /dev/null +++ b/docs/package_list/index.md @@ -0,0 +1,23 @@ +--- +title: Package List +--- +# FastTrack Package List + + +## FastTrack-Updates + +| Package | Major Version | Reason | Extra Notes | Date Added | +|---------- | -------------- | -------- | ------------ | ---------- | +| | | | | | +| | | | | | +| | | | | | + + +## FastTrack-New + +| Package | Major Version | Reason | Extra Notes | Date Added | +|---------- | -------------- | -------- | ------------ | ---------- | +| | | | | | +| | | | | | +| | | | | | + diff --git a/docs/repositories/index.md b/docs/repositories/index.md new file mode 100644 index 0000000..3106cc3 --- /dev/null +++ b/docs/repositories/index.md @@ -0,0 +1,32 @@ +--- +title: Repositories and Packages +--- +# Repositories + +There are 2 main FastTrack repositories: **FastTrack-Updates** and **FastTrack-New** . + +The -Updates repository contains newer versions of packages found in Rocky Linux, while the -New repository is exclusively new packages. + +## Updates Repo: Includes and Excludes + +The FastTrack-Updates repository in particular could be an issue for some users - what if you are only interested in updating certain packages on your system, but leaving others alone? This is not a problem for FastTrack-New , as you can simply opt to not install packages you don't want. + +To assist users, the FastTrack.repo file will have a couple comments explaining how to `includepkgs` and `excludepkgs` in DNF. Specifying includepkgs allows users to only receive updates for the listed packages, while excludepkgs allows them to ignore FastTrack updates of things they prefer to keep on the stock Rocky ones. + + +# Packages + +## Suggestions/Requests + +New packages can always be discussed for inclusion via issues at: [https://git.resf.org/sig_fasttrack/meta/issues](https://git.resf.org/sig_fasttrack/meta/issues) + +The best/fastest way to get a package included in the SIG is to have the build pre-complete in tested. That is, have a working git repository or SRPM somewhere that you've confirmed builds properly against Rocky Linux. We can then bring the package into dist-git under https://git.rockylinux.org/sig/fasttrack/src/PACKAGE and build + publish in the Rocky build system. + + +## Builds +Package builds *must* build with Rocky Linux dependencies only. (BaseOS/AppStream/PowerTools/Devel/etc.) + +Using 3rd party repos such as EPEL as dependencies is not allowed. 3rd party repositories are subject to change, and we do not want to depend on external packages in order to use SIG-FastTrack. If a package is dependent on other packages found in EPEL or other repos, these dependencies can be re-built and made available in the FastTrack repositories as well. + +A standard Mock config will be made available in the SIG's Git space for each major version of Rocky Linux. These Mock configs will reflect the SIG's Peridot build settings, so proper apples-to-apples testing of builds can be done locally by contributors. + diff --git a/mkdocs.yml b/mkdocs.yml index 562e6f6..a43aab2 100644 --- a/mkdocs.yml +++ b/mkdocs.yml @@ -62,6 +62,7 @@ plugins: - awesome-pages - git-revision-date-localized: type: date + fallback_to_build_date: true - search # Extensions