-
-
Notifications
You must be signed in to change notification settings - Fork 3
New issue
Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.
By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.
Already on GitHub? Sign in to your account
📖♻️:diffuse agent forwarding content for openinf core in 2024 #1106
Conversation
👷 Deploy Preview for open-inf-is processing.
|
6f46bcd
to
0253829
Compare
d8fb5dd
to
f633bdf
Compare
f633bdf
to
f2d9ab7
Compare
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
please excuse the roughness of this document as we develop it further;
this was not originally intended for any audience of readers other than myself
as they still seem to be closer to notes (?)
i am going to breakfast now, but fortunately starting to feel the passion
for this topic again, which motivates much more than anything
GPG keys to work correctly. So you have to ensure they are available on the | ||
remote system even if your secret keys are not. | ||
|
||
\[\[note\]\] |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
\[\[note\]\] | |
\[\[note\]\] |
btw, this cute lil admonition syntax was previously ruled as being non-preferable
[…] should've been a directive.
Square brackets are used a lot already in markdown […]
—https://twitter.com/wooorm/status/1701865524236345734
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
this would be a nice time for windings font selection
we'd have some diverse surrounding content and not all the text is uniform
🔗 https://dereknongeneric.github.io/agent-forwarding-eye-candy/agent-forwarding.html
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
y'know, at first i was having trouble deciding
whether to keep the leading section numbers or
move that to some other place that doesn't interfere,
but now i really like how their addition makes it look academic
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
btw, the HTML to Markdown conversion was done via online tool:
briefly glancing at the output; it had stripped wayyy more tags than Pandoc
so, i was like "screw it, nobody else even comes close", but not sure why
all the backslashes have been applied to basically anything that can be
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
re-reading OpenINF/GitHub-Markdown#4 now and
gearing up for its demolition, which we are running
late, but kaboom happens in ~2hr 15min (10pm EST)
who like me still feels weird about using the aside
HTML tag for them?
- http://html5doctor.com/understanding-aside/
- https://developers.google.com/style/notices
- https://docs.anaconda.com/restructuredtext/index.html#admonitions-notes
maybe i will feel better about it after reading those things on them
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
last note worth mentioning on styleguide conventions
similar to those seen elsewhere: we used to
have our own freaking baby styleguide in our top-level
org dotrepo:
in retrospect, i do not change my opinion about that being the wrong place for that handbook sub-project, which i was imagining would outgrow (in amount of content) the repo it had started in and the dot-prefix-namesake would soon have made no sense at all
regretting my decision of not migrating it else where tho
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
RE - ⬇️:
re-reading OpenINF/GitHub-Markdown#4 now and
gearing up for its demolition, which we are running
late, but kaboom happens in ~2hr 15min (10pm EST)
who like me still feels weird about using theaside
HTML tag for them?
- http://html5doctor.com/understanding-aside/
- https://developers.google.com/style/notices
- https://docs.anaconda.com/restructuredtext/index.html#admonitions-notes
maybe i will feel better about it after reading those things on them
Originally posted by @DerekNonGeneric in #1106 (comment)GF - 🏛️:
opted for making old GF contiue her life in archive formhttps://t.co/J61RYALoyX— OpenINF (@OpenINF) January 30, 2024
Originally posted by @DerekNonGeneric in #1106 (comment)
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
\[\[note\]\] | |
:::note{.note} |
the actual resulting suggestion is better than this (gimme a sec to dig it up)
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
the actual resulting suggestion is better than this (gimme a sec to dig it up)
🔗 https:/micromark/micromark-extension-directive?tab=readme-ov-file#syntax
micromark-extension-directive
has definitely thought this out more clearly
ok, a few more to consider; would like to have this "override" title
- https://www.adamsdesk.com/posts/admonitions-jekyll/
- https:/privacyguides/privacyguides.org/blob/1634bea9d2a66ef5804b68d18d4218e0b7a8b806/docs/meta/translations.md?plain=1#L2
- https://ericlikedis.github.io/posts/Admonitions-Documentation/
- https:/lazee/premonition
the translations can happen in the document if necessary
b9aefa8
to
27dde9b
Compare
PR URL: #1139 Reviewed-by: OpenINF Bot <[email protected]> Signed-off-by: Derek Lewis <[email protected]> Co-authored-by: Restyled.io <[email protected]>
Signed-off-by: Derek Lewis <[email protected]>
Signed-off-by: renovate[bot] <29139614+renovate[bot]@users.noreply.github.com>
PR URL: #1140 Reviewed-by: Derek Lewis <[email protected]> Reviewed-by: OpenINF Bot <[email protected]> Signed-off-by: dependabot[bot] <[email protected]> Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
PR URL: #1141 Reviewed-by: OpenINF Bot <[email protected]> Signed-off-by: Derek Lewis <[email protected]> Co-authored-by: Restyled.io <[email protected]> Acked-by: Princess Irulen <[email protected]>
PR URL: #1143 Reviewed-by: OpenINF Bot <[email protected]> Signed-off-by: dependabot[bot] <[email protected]> Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
This is an attempt to get #1142 passing CI. Refs: #1142 Signed-off-by: Derek Lewis <[email protected]>
PR URL: #1142 Reviewed-by: Derek Lewis <[email protected]> Reviewed-by: OpenINF Bot <[email protected]> Signed-off-by: renovate[bot] <29139614+renovate[bot]@users.noreply.github.com> Co-authored-by: renovate[bot] <29139614+renovate[bot]@users.noreply.github.com>
PR URL: #1145 Reviewed-by: Derek Lewis <[email protected]> Reviewed-by: OpenINF Bot <[email protected]> Signed-off-by: renovate[bot] <29139614+renovate[bot]@users.noreply.github.com> Co-authored-by: renovate[bot] <29139614+renovate[bot]@users.noreply.github.com>
Signed-off-by: Derek Lewis <[email protected]>
Signed-off-by: Derek Lewis <[email protected]>
Refs: https://x.com/OpenINF/status/1762686158784401517 PR URL: #1154 Reviewed-by: OpenINF Bot <[email protected]> Signed-off-by: Derek Lewis <[email protected]> Cc: Jorge Bucaran <[email protected]> Co-Authored-By: Princess Irulen <[email protected]>
Co-authored-by: Derek Lewis <[email protected]> Signed-off-by: OpenINF Bot <[email protected]>
Signed-off-by: OpenINF Bot <[email protected]>
Co-authored-by: Derek Lewis <[email protected]> Signed-off-by: OpenINF Bot <[email protected]>
this pr has unrelated changes in the diff; one moment |
Signed-off-by: Derek Lewis <[email protected]>
we are going to merge this tonight, even incomplete! |
let's make it a shell session instead
Codacy calls out a bunch of things still wrong with the document true, there are many things still wrong with the document we have not standardized many of the practices yet; so merging |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
i expect a revamp as follow-up
There is a secret sweetspot achieving delightful experience
otherwise not really something casual contributors should
be expected to be doing simply for making a contribution.
We should now be (and look to have already started on) taking the topic
in a few different directions (perhaps also improving discoverability):