- Jan 22, 2021
-
-
Walter Lozano authored
Fix some formatting issues, remarks and command names. Signed-off-by:
Walter Lozano <walter.lozano@collabora.com>
-
- Jan 15, 2021
-
-
As currently the infrastructure repository uses only a master branch update the links accordingly. Signed-off-by:
Walter Lozano <walter.lozano@collabora.com>
-
- Dec 21, 2020
-
-
Walter Lozano authored
As a reference for the installation of Automated License Compliance add a guide to pointing to the pieces of software to be installed and upgraded. Signed-off-by:
Walter Lozano <walter.lozano@collabora.com>
-
Ritesh Raj Sarraf authored
When a new release is branched, we need to ensure that a proper rotation job is set for the respective release. In this example, we instantiate a new timer for rotation of the images Signed-off-by:
Ritesh Raj Sarraf <ritesh.sarraf@collabora.com>
-
- Dec 18, 2020
-
-
Ritesh Raj Sarraf authored
For most major task, our user account suffice on OBS. But there are certain exceptions, like creating new repositories, wherein we need Admin level privileges. This is required when we create new repositories for a stable release: security, updates, backports. Document this oddity that the user needs to have Admin level privileges Signed-off-by:
Ritesh Raj Sarraf <ritesh.sarraf@collabora.com>
-
- Dec 08, 2020
-
-
Merge the useful bits of the "wip" AppArmor documentation into the main AppArmor document. Signed-off-by:
Martyn Welch <martyn.welch@collabora.com>
-
Signed-off-by:
Emanuele Aina <emanuele.aina@collabora.com>
-
https://mtlynch.io/code-review-love/
The "How to Make Your Code Reviewer Fall in Love with You" post provide a nice and entertaining guide on submitting changes for review. Signed-off-by:
Emanuele Aina <emanuele.aina@collabora.com>
-
- Nov 17, 2020
-
-
Martyn Welch authored
The Apertis documentation refers to the role of maintainer in a number of places, but never defines what the role entails. Add a section to cover this role, linking to it from places where it is relevant. Signed-off-by:
Martyn Welch <martyn.welch@collabora.com>
-
Martyn Welch authored
The "contribution process" as much details Apertis' policies with regards to contributions as laying out a process. Rename the page to simply "contributions" to make the scope of the document a bit clearer. Signed-off-by:
Martyn Welch <martyn.welch@collabora.com>
-
Martyn Welch authored
The contribution process document contains both policy information as well as more of a development guide. Split the development guide section out as it's own document in guides rather than having it contained in the policy document. Signed-off-by:
Martyn Welch <martyn.welch@collabora.com>
-
- Nov 16, 2020
-
-
Move the last of the developer documents to sensible locations, adding warnings where documents are clearly based on the legacy Canterbury framework. Remove the link to the developer section from the main page since it no longer exists. Signed-off-by:
Martyn Welch <martyn.welch@collabora.com>
-
We have two documents describing how to use ADE, merge them. Signed-off-by:
Martyn Welch <martyn.welch@collabora.com>
-
- Nov 09, 2020
-
-
Walter Lozano authored
Add a paragraph to enforce the release early, release often philosophy to give better context about the number of MR to include in a release commit. Signed-off-by:
Walter Lozano <walter.lozano@collabora.com>
-
- Oct 23, 2020
-
-
Based on the example previously presented update the gitlab-rulez example Signed-off-by:
Walter Lozano <walter.lozano@collabora.com>
-
Fix the commit message example showing the correct path for the file changed. Signed-off-by:
Walter Lozano <walter.lozano@collabora.com>
-
- Oct 22, 2020
-
-
The persistent workspace documentation is currently in the SDK usage document. The usage document covers some very basic usage, whilst the persistent workspace is a little bit more of an advanced topic. Split it out into its own document and move both to guides. Additionally the design document is still present for the persistent workspace feature. This is now redundant since the design has been implemented. Move the limited amount of pertanent information from the design document to the guide and remove the design document to avoid confusion. Signed-off-by:
Martyn Welch <martyn.welch@collabora.com>
-
We are rapidly removing the developer section, remove the index that is broadly covered elsewhere. The FAQ is also either covered elsewhere or completely out of date. The programming guides have been moved to the main guide section and thus this is now pointless. Signed-off-by:
Martyn Welch <martyn.welch@collabora.com>
-
The deployment guide is becomming a bit out-of-date, tweak to improve readability and update the out-dated sections. Sort in to the new layout under guides. Signed-off-by:
Martyn Welch <martyn.welch@collabora.com>
-
Move pstore guide, lightly edit to improve formatting. Signed-off-by:
Martyn Welch <martyn.welch@collabora.com>
-
Move the cross toolchain documentation to guides, doing some light editing to make the advise more consistent. Signed-off-by:
Martyn Welch <martyn.welch@collabora.com>
-
The network development document is incomplete, missing out instructions for setting up NFS and TFTP: - Add these sections - Lightly rework the document to improve wording and layout - Move to guides section Signed-off-by:
Martyn Welch <martyn.welch@collabora.com>
-
- Oct 19, 2020
-
-
Martyn Welch authored
The VirtualBox documentation from developer.apertis.org broadly covers the same topics as the VirtualBox documentation the already existed on the main website. Merge these together. Topics not closely tied to VirtualBox have been moved to other pieces of documentation where they are better suited. Signed-off-by:
Martyn Welch <martyn.welch@collabora.com>
-
Martyn Welch authored
The developer documentation contains a number of documents that are duplicated from the wiki. Remove the duplications, ensuring the remaining copies are up-to-date. Signed-off-by:
Martyn Welch <martyn.welch@collabora.com>
-
- Oct 13, 2020
-
-
Move documents out of designs and into more suitable locations following the layout guidelines. Perform some minor edits to correct typos and remove unneeded titles. Signed-off-by:
Martyn Welch <martyn.welch@collabora.com>
-
- Oct 12, 2020
-
-
Ritesh Raj Sarraf authored
.gitattributes is used by many projects in their development workflows. THis can, many a times, interfere with the Apertis package development workflow. Thus document the fix for such cases. Signed-off-by:
Ritesh Raj Sarraf <ritesh.sarraf@collabora.com>
-
The base-files package, depending on its branch name, generates the os distribution specific attributes. Since those attributes expect a certain set of infrastructure changes available (eg. new release's docker images), this step is classified to be executed manually. Signed-off-by:
Ritesh Raj Sarraf <ritesh.sarraf@collabora.com>
-
- Oct 02, 2020
-
-
Add a basic description to the index page for each of the "official" sections (as laid out inthe websites README.md). This provides visitors to the site with some guidance as to what to expect to find in each section, somewhere to point out to related polices (such as the release schedule and flow from the releases section) and a way to add aliases (such as the missing alias to Guides for the "Guidelines" section that was found on the old wiki). Signed-off-by:
Martyn Welch <martyn.welch@collabora.com>
-
- Sep 24, 2020
-
-
Ritesh Raj Sarraf authored
This documents the invocation of the automation script for folding changes. And also emphasizes that the final result should be validated manually. Signed-off-by:
Ritesh Raj Sarraf <ritesh.sarraf@collabora.com>
-
- Aug 03, 2020
-
-
Ritesh Raj Sarraf authored
This is required when the cleaning up and recovering space. Usually, the beta, development and preview releases are the common candidates for removal Signed-off-by:
Ritesh Raj Sarraf <ritesh.sarraf@collabora.com>
-
- Jul 29, 2020
-
-
After moving the documents from designs.a.o to www.a.o, there were quite a few links from the designs.a.o docs pointing to wiki.a.o and quite a few links from www.a.o pointing to designs.a.o. Replace these links with Hugo ref shortcodes to avoid hammering the redirects. This was achieved with the following script: ``` import os import re import sys import toml from urllib.parse import urlparse def get_aliases(filename): #print("%s: " % filename) with open(filename, 'r') as file: contents = file.read() if not contents[0:3] == "+++": return if "_index.md" in filename: filename = filename.strip(".") else: filename = filename.split("/")[-1] data = toml.loads(contents.split("+++")[1]) if not "aliases" in data.keys(): return for alias in data["aliases"]: if "/old-wiki/" in alias: wiki_aliases[alias.replace("/old-wiki/", "/")] = filename if "/old-designs/" in alias: # We're dropping the per-release links from designs.a.o, so match on shorter path design_aliases[alias.replace("/old-designs/latest/", "/")] = filename def fix_link(url): link = url.group('link') url = urlparse(link) if url.netloc == "wiki.apertis.org": if url.path in wiki_aliases.keys(): url = url._replace(scheme="") url = url._replace(netloc="") url = url._replace(path=wiki_aliases[url.path]) link = " {{< ref \"%s\" >}} " % url.geturl() if url.netloc == "designs.apertis.org": # We're dropping the per-release links from designs.a.o, so match on shorter path path = "/%s" % url.path.split('/', 2)[-1] print(path) if path in design_aliases.keys(): url = url._replace(scheme="") url = url._replace(netloc="") url = url._replace(path=design_aliases[path]) link = " {{< ref \"%s\" >}} " % url.geturl() return "](%s)" % link def fix_ref(url): link = url.group('link') url = urlparse(link) if url.netloc == "wiki.apertis.org": if url.path in wiki_aliases.keys(): url = url._replace(scheme="") url = url._replace(netloc="") url = url._replace(path=wiki_aliases[url.path]) link = " {{< ref \"%s\" >}} " % url.geturl() if url.netloc == "designs.apertis.org": # We're dropping the per-release links from designs.a.o, so match on shorter path path = "/%s" % url.path.split('/', 2)[-1] print(path) if path in design_aliases.keys(): url = url._replace(scheme="") url = url._replace(netloc="") url = url._replace(path=design_aliases[path]) link = " {{< ref \"%s\" >}} " % url.geturl() return "]: %s" % link def correct_links(filename): #print("%s: " % filename) with open(filename, 'r+') as file: contents = file.read() if not contents[0:3] == "+++": return fm = contents.split("+++")[1] doc = contents.split("+++",2)[2] # Hotdoc allows empty links like `[](url)` pattern = re.compile("\]\((?P<link>.*?)\)") doc = pattern.sub(fix_link, doc) pattern = re.compile("\]: (?P<link>.*)") doc = pattern.sub(fix_ref, doc) file.seek(0) file.truncate() file.write("+++") file.write(fm) file.write("+++") file.write(doc) wiki_aliases = {} design_aliases = {} for root, dirs, files in os.walk(sys.argv[1]): for file in files: if ".md" in file: get_aliases("%s/%s" %(root, file)) print("wiki_aliases:") print(wiki_aliases) print("design_aliases:") print(design_aliases) for root, dirs, files in os.walk(sys.argv[1]): for file in files: if ".md" in file: correct_links("%s/%s" %(root, file)) ``` Signed-off-by:
Martyn Welch <martyn.welch@collabora.com>
-
- Jul 27, 2020
-
-
Ritesh Raj Sarraf authored
This file is used throughout our Apertis packaging repositories by all packages. It specifies which repository component a package is part of Signed-off-by:
Ritesh Raj Sarraf <ritesh.sarraf@collabora.com>
-
Document the process for updating packages where we pull from an upstream (non-Debian) source, such as we do for the LTS v.5.4 kernel. Signed-off-by:
Martyn Welch <martyn.welch@collabora.com>
-
- Jul 24, 2020
-
-
The versioning information doesn't sit very well in the releasing packages guide. Add this to the information on binary package versioning to make a more holistic page on versioning. Move the information on dch tags to the version_control guide where it is mentioned. The rest of this guide is very out of date. We have a number of other guides on releasing packages, drop this one. Signed-off-by:
Martyn Welch <martyn.welch@collabora.com>
-
More of the guides still seem relevant and good information. Tweak the formatting and move these to guides. Signed-off-by:
Martyn Welch <martyn.welch@collabora.com>
-
Ritesh Raj Sarraf authored
* Reorder each example under each chunk * Indent the examples so that they are rendered proper in hugo Signed-off-by:
Ritesh Raj Sarraf <ritesh.sarraf@collabora.com>
-
Ritesh Raj Sarraf authored
* Cleanup paragraph * Add date and weight field * Use reference shortcodes * Strip shell prompt Signed-off-by:
Ritesh Raj Sarraf <ritesh.sarraf@collabora.com>
-
- Jul 19, 2020
-
-
Ritesh Raj Sarraf authored
Moved from ci-package-builder Signed-off-by:
Ritesh Raj Sarraf <ritesh.sarraf@collabora.com>
-
- Jul 15, 2020
-
-
Ritesh Raj Sarraf authored
That every rebuild repository should have the following meta attribute set because otherwise, packages would run into a cyclic build loop. rebuild="local" block="never" Signed-off-by:
Ritesh Raj Sarraf <ritesh.sarraf@collabora.com>
-
Ritesh Raj Sarraf authored
Signed-off-by:
Ritesh Raj Sarraf <ritesh.sarraf@collabora.com>
-