From: Silvano Cirujano Cuesta <silvano.cirujano-cuesta@siemens.com>
To: isar-users@googlegroups.com
Subject: [RFC PATCH v3 0/1] Documentation: dependencies specification in Bitbake and Debian
Date: Wed, 3 Apr 2019 11:13:03 +0200 [thread overview]
Message-ID: <20190403091304.8087-1-silvano.cirujano-cuesta@siemens.com> (raw)
Hi,
I've tried to document my understanding on dependency management at different areas in ISAR.
I've done it mostly to structure it in my head.
But I'm also convinced that this kind of documentation is critical for lowering the entry barrier to ISAR usage, therefore I'm sending it to this mailing list.
With this request for comments I want to:
1. gather comments about the demand for such documentation
2. gather comments about the content to make sure that I didn't misunderstood how it works
Once I get confirmation for the demand and any possible misconception clarified, I'll provide a patch integrating it with the already existing documentation.
I've taken Claudius feedback to previous versions of the RFC into account (thank you again for your very valuable input!).
And I let two colleagues of mine with a similar superficial/deep knowledge of ISAR review it.
Right now it's everything in a single MarkDown document, but I'd rather put the section "Dependency specification variables" into a separate document.
I keep it together right now to simplify the reviews.
For those of you who like to have some comfort in life, I've pushed the document to a fork of ISAR in my personal area.
That way you can take advantage of MarkDown conversion to HTML and rendering going to [1] ;-)
Regards,
Silvano
[1] https://github.com/Silvanoc/isar/blob/silvano/dependencies-documentation/doc/dependencies.md
Silvano Cirujano Cuesta (1):
docs: ading dependencies documentation
doc/dependencies.md | 255 ++++++++++++++++++++++++++++++++++++++++++++++++++++
1 file changed, 255 insertions(+)
create mode 100644 doc/dependencies.md
--
2.11.0
next reply other threads:[~2019-04-03 9:13 UTC|newest]
Thread overview: 3+ messages / expand[flat|nested] mbox.gz Atom feed top
2019-04-03 9:13 Silvano Cirujano Cuesta [this message]
2019-04-03 9:13 ` [RFC PATCH v3 1/1] docs: ading dependencies documentation Silvano Cirujano Cuesta
2019-04-08 10:44 ` Andreas Reichel
Reply instructions:
You may reply publicly to this message via plain-text email
using any one of the following methods:
* Save the following mbox file, import it into your mail client,
and reply-to-all from there: mbox
Avoid top-posting and favor interleaved quoting:
https://en.wikipedia.org/wiki/Posting_style#Interleaved_style
* Reply using the --to, --cc, and --in-reply-to
switches of git-send-email(1):
git send-email \
--in-reply-to=20190403091304.8087-1-silvano.cirujano-cuesta@siemens.com \
--to=silvano.cirujano-cuesta@siemens.com \
--cc=isar-users@googlegroups.com \
/path/to/YOUR_REPLY
https://kernel.org/pub/software/scm/git/docs/git-send-email.html
* If your mail client supports setting the In-Reply-To header
via mailto: links, try the mailto: link
Be sure your reply has a Subject: header at the top and a blank line
before the message body.
This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox