bolha.us is one of the many independent Mastodon servers you can use to participate in the fediverse.
We're a Brazilian IT Community. We love IT/DevOps/Cloud, but we also love to talk about life, the universe, and more. | Nós somos uma comunidade de TI Brasileira, gostamos de Dev/DevOps/Cloud e mais!

Server stats:

254
active users

#tagging

0 posts0 participants0 posts today

In case you missed it, a couple weeks ago the @PDFassociation published a web page listing "Tools for Accessible PDF".

There are two tables listing various tools along with columns for platform and license - one table for commercial, the other for free and/or open source. The lists include pretty much all the major vendors and tools, as well as a few that I didn't even know about (!).

pdfa.org/tools-for-accessible-

pdfa.orgTools for Accessible PDF – PDF Association

Latest attempt at building better documentation for thi.ng/umbrella (also to make it available offline!): Having noticed that recent versions of TypeDoc support extracting & merging of doc strings from monorepos, over the past few weeks I've been updating/cleaning docstrings in hundreds of source files across all 200+ packages and started building a small tool to assemble a single/mega-page documentation (currently ~4.3MB of just HTML). The tool translates existing docstrings and references contained therein (and still used for the existing API docs) to support proper cross-package references.

I've uploaded an early preview here:
docs.thi.ng/umbrella/

Please be aware that so far this is only an early stage prototype and only contains very limited docs. I.e. there are no generics/typeparams, no details about classes/interfaces... But at least I know now HOW to add this all, as well as all the additional metadata I've already got (currently still only available via other custom tools/examples).

For example, there're links to the tag-based browser[1] and I'm also planning to add the fuzzy doc search engine/index[2] to this new documentation... The tag browser integration still needs more work in terms of correctly matching package names to tags. The underlying system is there already, just needs more work in terms of actually doing/assigning the concept mapping. Since most package names in thi.ng/umbrella are very plain/boring (for a reason), for many (most?) packages this already works pretty well:

Example: Visiting the WebGL package docs: docs.thi.ng/umbrella/#webgl and then clicking on "examples" for this package, then opens the tag browser for WebGL: demo.thi.ng/umbrella/thing-bro where you can then see all other packages and examples related to this topic...

More updates on this all soon! Excited! 🤩

(EDIT: added screenshots...)

[1] demo.thi.ng/umbrella/thing-bro
[2] demo.thi.ng/umbrella/rdom-sear

Replied in thread

@Serenus @sandwich

#contentWarning and #tagging are very different

tagged content flows by at the same level of exposure

content warning hides content from general consumption, putting up an additional barrier to engage with it

for plenty of topics: sex, violence, etc, it is an utterly valid ask

but to ask someone to content warn something that doesn't require a content warn by any coherent rationale?

this is asking the world to bend to your personal preferences on contrived entitlement

Replied in thread

@Serenus @sandwich

yes: #tagging is a completely different story than #contentWarning and i agree with you wholeheartedly

it allows people who want to be engaged in the same content as you to find you

and the inverse:

it allows others who want to avoid the content you are engaged in to avoid you

and *that* is the way it should be

i am not entirely sure there is or ever will be a better option