Open kousu opened 2 years ago
(extracted from the Twitter thread)
In the startup world, these company handbooks have been particularly influential for their radical openness:
get (some) consensus on the rhetorical goal of the docs
I'm a little confused about what this question is asking... 🤔
decide terminology: "site" vs "wiki", "intranet" vs "lab manual"
Personally, I prefer:
neuro.polymtl.ca
(to me) is first and foremost a landing page for people looking to learn more about the lab.)decide if updates will be ad-hoc or scheduled as an annual lab-wide team project
Ad-hoc is the current approach, and I feel like it's worked... well enough so far?
Plus, I'm a bit hesitant about any big new scheduled efforts, considering how easy it is to propose, hype up, then eventually drop an idea. Coordination is difficult and labour-intensive! I'm skeptical about whether it would possible to rope the full lab into... working on internal docs? :sweat_smile:
Myself, I would propose:
I don't really have any complaints about anything you've proposed. :slightly_smiling_face:
Lab website ("Wiki" makes me think of an internal knowledge source, but neuro.polymtl.ca (to me) is first and foremost a landing page for people looking to learn more about the lab.)
👍
Lab manual. ("Intranet" to me feels like a functional term -- a set of pages that are only accessible via a specific internal network. Our lab manual is definitely not that, so the term always felt a bit misleading to me.)
i don't have a strong feeling but the only thing in favor of the 'intranet' is that the URL says 'intranet.xxx'. But i guess that's not tooooo confusing...
As I recall it, redoing the website -- getting it off dokuwiki and making contributions a lot more accessible -- was inspired by this thread in March where @jcohenadad asked @neuropoly/consultants and @neuropoly/research-associates to review this other thread which opens
Now that the migration is settling down, we should all reflect what the purpose of the sites (both https://github.com/neuropoly/neuro.polymtl.ca and https://github.com/neuropoly/intranet.neuro.polymtl.ca) are.
I think we should be proud that the internal docs are now open source, not locked behind the old "internal resources" link, largely thanks to @ahill187's month+ porting and sorting through old data (thank you so much for grinding through that!). It means we've achieved this!:
I was enthusiastic about that and about all the thread's other examples that encourage open sourcing lab knowledge, not just in research processes but also in bureaucratic and cultural ones. Most people won't be interested, but for candidates considering joining us, other labs looking to compare or improve, or just ourselves, having a well-curated manual that's easy use from anywhere is very helpful. Holding ourselves to well-documented open source academics I hope will push us to take less shortcuts and make the processes themselves more rationalized and sustainable; and where they're not at least we have the institutional knowledge archived.
In this thread I would like us to:
Myself, I would propose: