Engineering sync minutes - NetworkGradeLinux/mion-docs GitHub Wiki
NGL mion Engineering Sync Minutes
2021-02-17
Agenda
Discussion of P4, progress is being made.
Update on mion QEMU, switched from arm to x86-64 Update on se-linux
Discussion of Dent and ONL switch dev already in kernel
2021-02-03
No Engineering Sync due to project lead absence
2012-01-20
Agenda
Documentation Maintainer: Doc website support for versioning; issue around tags or branches for tracking versioning.
mion Maintainer: Issues around package feeds and world builds
Review of priority tags on project board
Documentation Versioning
Documentation site https://docs.mion.io needs to support and host different release versions. As this is not readily supported in Jekyll, the decision had previously been made to switch to using MKdocs. However there are two ways to track release versions: git tags or branches. With tags, the ability to correct past documentation errors isn't possible. However as tags provide a "snapshot in time", and is how the other repos are handled, it was decided that we should use tags, however the documentation maintainer mentioned that this may potentially complicate the implementation.
An overview of how MKdocs and Jekyll differ in how the content is generated was given; Jekyll is built on github whenever the branch being tracked for github pages is changed, MKdocs is built locally and the generated site is pushed to the tracked github page. This requires a change in how we approach the doc website, which may require modification to the branching strategy.
It was also later mentioned that documentation should have a QA process. This would help prevent any need to go back and edit documentation for past releases.
Package Feed and World Builds
A request was made to explain the topic of world builds and how it relates to a package feed. A summary follows:
Bitbake can build Universe and World, where Universe is similar to the
mathematical use of the term, representing all packages for all
architectures/machines...this is mostly used for CV checks. World is a subset,
which can be arch specific or non arch specific, and is everything that can be
built. This is commonly run with bitbake -k
to build packages even if not all
dependencies are met. World Builds are primarily useful for generating a package
feed. A package feed would allow for the familiar Linux style package
management.
It was mentioned that there needs to be a workaround regarding a world build and proprietary SDE's.
Once the package feed is available, it will need to be documented on how to update.
Most packages are from layers we do not control. For those who have the package feed as their remote, security patches would be included, which would generally be build on Fridays.
Regarding packages, an rsync of packages that require distribution of source due to their license will need to be set up, with a need to filter out that should not be published publicly.
Packages are to be be in the IPK format. It's also encouraged that those adopting mion customize it and generate their own package feeds with the package manager and format that best suits their need.
Review of Priority Levels
Only one issue on the project board had a change to documentation, where copyright info footers for documentation was changed from "low" to "medium".
Other
It was mentioned that a solution to replace busybox and the limits it has needs to be implemented, but also one that excludes unnecessary tools.
Need to define update strategy for all installation tasks.(related to documentation)