Skip to content
Snippets Groups Projects
  1. May 04, 2021
  2. Apr 29, 2021
    • Arnaud Ferraris's avatar
      Enable table of contents for relevant pages · baf9ff9a
      Arnaud Ferraris authored
      
      This commit enables the generation and display of the ToC on all pages
      where it's relevant due to the content size.
      
      More pages could have been included but left aside due to inconsistent
      use of heading levels leading to rendering/visual glitches.
      
      The pages' content has not been modified, except for the "Terms of use"
      page which included a manually-generated ToC.
      
      Signed-off-by: default avatarArnaud Ferraris <arnaud.ferraris@collabora.com>
      baf9ff9a
  3. Apr 26, 2021
  4. Mar 29, 2021
  5. Feb 23, 2021
  6. Feb 16, 2021
  7. Feb 03, 2021
  8. Jan 24, 2021
  9. Jan 22, 2021
  10. Dec 22, 2020
  11. Nov 18, 2020
  12. Nov 17, 2020
  13. Nov 16, 2020
  14. Nov 11, 2020
    • Martyn Welch's avatar
      Update the Apertis platform document · 6ac2d1f9
      Martyn Welch authored
      
      The Apertis platform document is out of date. Update it to reflect some
      changes to the Apertis project that have been true for a while:
      
      - We use GitLab rather than straight git repositories
      - All code is stored in GitLab (rather than as packages in OBS)
      - We use GitLab for code review rather than Phabricator
      - Automation has been moved from Jenkins to GitLab CI/CD
      - We don't interact directly with OBS much any more
      - We use OSTree for OTA updates
      
      Also, remove the comparison with Yocto as this is neither overly balanced,
      accurate nor useful.
      
      Signed-off-by: default avatarMartyn Welch <martyn.welch@collabora.com>
      6ac2d1f9
  15. Nov 02, 2020
  16. Oct 22, 2020
  17. Oct 19, 2020
  18. Oct 15, 2020
  19. Oct 13, 2020
  20. Oct 02, 2020
  21. Sep 23, 2020
    • Emanuele Aina's avatar
      image-build-infrastructure: Mark as obsolete · e39cd6e1
      Emanuele Aina authored and Martyn Welch's avatar Martyn Welch committed
      
      This document describes how we built images on Jenkins, but we have now
      largely moved away from it in favor of GitLab CI/CD.
      
      The README in the infrastructure/apertis-image-recipes> project
      describes the current setup closer to the actual code.
      
      Keep the document around since v2019 and v2020 are still officially on
      Jenkins and old release notes still point here.
      
      Signed-off-by: Emanuele Aina's avatarEmanuele Aina <emanuele.aina@collabora.com>
      e39cd6e1
  22. Sep 22, 2020
  23. Sep 03, 2020
    • Martyn Welch's avatar
      Update and classify a batch of design documents · 786fb549
      Martyn Welch authored and Emanuele Aina's avatar Emanuele Aina committed
      
      The design documents imported from designs.apertis.org need to be
      classified and moved into the structure implemented for documents on the
      new website. The content of the documents also need minor edits to ensure
      a good look and feel as well as the addition of notes to explain the
      context of some documents (such as noting that certain concept documents
      have been implemented since they were written and when that occurred).
      
      This commit contains conversion of an initial batch of design documents.
      
      Signed-off-by: default avatarMartyn Welch <martyn.welch@collabora.com>
      786fb549
  24. Jul 29, 2020
    • Martyn Welch's avatar
      Updating old links · ee26b8cf
      Martyn Welch authored and Emanuele Aina's avatar Emanuele Aina committed
      
      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: default avatarMartyn Welch <martyn.welch@collabora.com>
      ee26b8cf
  25. Jul 24, 2020
  26. Jul 13, 2020
  27. Jun 30, 2020
  28. May 28, 2020
    • Martyn Welch's avatar
      Update system startup and split document · 10fe1873
      Martyn Welch authored and Emanuele Aina's avatar Emanuele Aina committed
      
      The system startup document is out of date. Provide a brief updated
      description of the Apertis boot process and move to a new "architecture"
      section. Split out the boot analysis into its own document and move to a
      new "guides" section. Remove the previously performed optimisations as
      these describe patched in changes that no longer appear to be a part
      of Apertis.
      
      Signed-off-by: default avatarMartyn Welch <martyn.welch@collabora.com>
      10fe1873
Loading