neuropoly / intranet.neuro.polymtl.ca

NeuroPoly's lab manual
https://intranet.neuro.polymtl.ca
4 stars 6 forks source link

"Lab Manual" #25

Open kousu opened 2 years ago

kousu commented 2 years ago

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

Russ Poldrack @russpoldrack Mar 25 I’d like to develop a public-facing Standard Operation Procedures page for our lab, outlining our default practices. Does anyone have good examples (from your own lab or others) that we might build off of?

4:04 PM · Mar 25, 2021

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!:

has an easy to navigate, simple and nice interface. I'd advocate for rendering from GitHub via markdown for easy contribution.

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:

kousu commented 2 years ago

Examples

(extracted from the Twitter thread)

In the startup world, these company handbooks have been particularly influential for their radical openness:

Meta-manuals

joshuacwnewton commented 2 years ago

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:

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:

jcohenadad commented 2 years ago

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...