What is this?
This is the official reference book for Astrid, covering its kernel, capsule model, host ABI, IPC bus, and security model.
This is the official reference book for Astrid, covering its kernel, capsule model, host ABI, IPC bus, and security model.Is this Astrid itself or just the documentation?It's a static documentation book built with mdBook, not runtime software; it describes Astrid rather than running it.
It's a static documentation book built with mdBook, not runtime software; it describes Astrid rather than running it.How do I build this book?Check it out as a sibling to the core/, wit/, and capsules/ repos of the Astrid polyrepo, run the appendix generator scripts, then build with mdBook.
Check it out as a sibling to the core/, wit/, and capsules/ repos of the Astrid polyrepo, run the appendix generator scripts, then build with mdBook.Do I need the rest of the Astrid source tree to build this?Yes. The appendices are generated by tools/gen-appendices.sh and the cross-chapter links by tools/gen-see-also.pl, and both scripts read the full polyrepo source.
Yes. The appendices are generated by tools/gen-appendices.sh and the cross-chapter links by tools/gen-see-also.pl, and both scripts read the full polyrepo source.Can I build it as a standalone checkout?No, building a fully accurate copy requires the core/, wit/, and capsules/ repos checked out alongside this one, since the generator scripts read across them.
No, building a fully accurate copy requires the core/, wit/, and capsules/ repos checked out alongside this one, since the generator scripts read across them.What does the generated capability catalog appendix cover?It is produced by tools/gen-appendices.sh and includes the capability catalog, host ABI error codes, and the topic registry pulled directly from Astrid's source.
It is produced by tools/gen-appendices.sh and includes the capability catalog, host ABI error codes, and the topic registry pulled directly from Astrid's source.Why does a Perl script handle the cross-chapter links?tools/gen-see-also.pl scans the polyrepo source to auto-generate the 'See also' footers that connect related chapters across the book.
tools/gen-see-also.pl scans the polyrepo source to auto-generate the 'See also' footers that connect related chapters across the book.What are similar projects?rfcs, android-internals-wiki, CppCoreGuidelines, architecture-decision-record, linux-insides, cognitive-load, jvm, how-web-works
rfcs, android-internals-wiki, CppCoreGuidelines, architecture-decision-record, linux-insides, cognitive-load, jvm, how-web-worksWhich topics is it in?perl, runtime, kernel, architecture, book, reference, guide, documentation, markdown, security, api, apache-2.0
perl, runtime, kernel, architecture, book, reference, guide, documentation, markdown, security, api, apache-2.0