Skip to content
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

Create a meta.md file #17

Open
kallewesterling opened this issue Jun 17, 2020 · 8 comments
Open

Create a meta.md file #17

kallewesterling opened this issue Jun 17, 2020 · 8 comments
Assignees
Labels
Milestone

Comments

@kallewesterling
Copy link
Member

kallewesterling commented Jun 17, 2020

Drawing on #11, #13, #14 to outline what a meta.md should look like.

Tagged with sprint 2 as I think this is something we might ask fellows to do in that sprint.

@kallewesterling
Copy link
Member Author

So far we have:

  • title
  • copyright information
  • author information
  • acknowledgements —> authorship of each update
  • information about feedback
  • how to contribute (..?)
  • works cited
  • connecting different parts of workshop (to other database tables)

@kallewesterling
Copy link
Member Author

kallewesterling commented Jun 17, 2020

As referenced in #12, each of the sections need to be regularized (for programmatic population of database) and clearly communicated to the fellows.

See also project-lab's README.md for Lisa's draft of what a meta.md could look like.

@kallewesterling
Copy link
Member Author

kallewesterling commented Jun 17, 2020

We have also discussed:

  • acknowledgement of funding (NEH... future funding)

This, however, seems to pertain not to each workshop but to the project as a whole, and we might just want to hardcode this into the site — alternatively add another meta-layer for the website itself.

I could envision that there could be "standards" set up in the website meta layer, that could be overridden, for example, by an individual workshop. User stories (sort of):

  • We receive funding to develop a new workshop and want to acknowledge funding of the whole project (and the previous workshops) by one funder but add a specific funding source to the newly funded workshop (that does not apply to other workshops).
  • We develop a workshop that we want to keep with a different license than the CC that applies to the website as a whole.

@kallewesterling
Copy link
Member Author

kallewesterling commented Jun 17, 2020

In #13, you had asked for a more visual way of seeing how this ties in with everything, @lmrhody.

I spent two hours this morning drawing up some wireframes. They're pretty hefty, so the image made my computer a little laggy... If you right-click and save the file on your Mac, and then opening it in Preview, it might work better than looking at it in the browser:

https://raw.githubusercontent.com/DHRI-Curriculum/django-app/alpha-1/sketches/alpha-1-sketches-june-17.png

They might be good for us to have in our meeting tomorrow, as this is how I have envisioned how we can move the current GitHub curricular materials into a django site. But consider them suggestions—feel free to draw, on top or annotate the image however you see fit, and either send back to me (via Slack/email) or just add to the sketches directory on the django-app repo.

@kallewesterling
Copy link
Member Author

This is also where we want to include warnings/known compatibility issues:

DHRI-Curriculum/django-app#87

@kallewesterling
Copy link
Member Author

@kallewesterling
Copy link
Member Author

Instead of referring to next/previous workshops, as I wrote 10 days ago, I think we might want to consider a Tracks app for the django site instead: DHRI-Curriculum/django-app#139

@kallewesterling
Copy link
Member Author

@lmrhody I am also revisiting this workshop now, before you finish this up, and to test-ingest it into the website before I leave the project. Thus, changing things around. Some of the things you had added to the README.md will not be ingested since some of the sections were not formalized in our work last summer (for example, "History", "How to use this workshop", "How to contribute to this workshop", and "Contact Us" + the licensing information). Rather, we had discussed adding this as yet another file in the repositories (see this issue). Thus, I'll move things around a bit.

Before you start editing, I would therefore recommend that you pull the workshop on Monday or early in the week from GitHub, so as to not end up with a whole lot of patching between files.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
Projects
None yet
Development

No branches or pull requests

2 participants