cu-mkp / gr8975 Goto Github PK

https://github.com/cu-mkp/GR8975/blob/master/user_stories.md#cs-student----make-interface-more-intuitive----to-improve-user-experience

Is it a problem to have multiple URLs in the "image_url" field? Separate by semicolon? Or separate into fresh columns?

one of my recipes calls for "gum or glue". Should both be listed as ingredients? Just one? Do we want to track the relationship between ingredients (in this case, that one can be substituted for the other)?

Some materials don't easily fit into either of these categories.

For instance, fol. 102r_2 ("For the furnace") calls for "turnipseed oil for the lamps to heat the furnace". Turnipseed oil isn't an ingredient per se, since it doesn't go into any final product. But calling oil a tool doesn't really make sense either.

Do we want to use

1. Library of Congress standards (e.g., molding--crayfish)
2. semicolon separated syntax (e.g., molding; molding crayfish) — and what of redundancy?
3. separate fields (e.g., "Generic Activity: molding" ; "Specific Activity: crayfish")

see: https://github.com/cu-mkp/GR8975/blob/master/user_stories.md#hs-chemistry-student----search-for-chemical-ingredients-things-familiar-to-chem-students----try-them-out-for-ourselves

see: https://github.com/cu-mkp/GR8975/blob/master/user_stories.md#hs-chemistry-student----search-for-chemical-ingredients-things-familiar-to-chem-students----try-them-out-for-ourselves

Example: the titles of the recipes have the spelling 'moulds' while the text of the recipes usually follow the spelling 'mold'. I am writing them down according to how it is spelled on Github. But may be we need to discuss spelling compatibility to fix these differences.

I could not find folio 161r on github, but it is there on the pdf English translation with the identifier p161r_1 and heading 'preparing sand for box molds' .

The main problem is the ingredients of the recipe. In the folios in Google Drive, the materials in the recipes just marked by the “m” code which I assume to be materials. The instruments in the recipe are not marked as the same. However, some marked materials seems ambiguous concerning its status in the recipes. They are not ingredients, and also can not count into instruments. For example the water for soaking (p074v_2), marble used to put materials on when burnishing (p075r_2, p078v_1,p078v_4), charcoal or manual or dung used for heating (p074r_3, p076r_1, p078r_3), paper or cards used when crushing (p077r_a4), wood or tooth used, for burnishing (p074v_3, p078v_1, p078v_2).

see google spreadsheet

https://github.com/cu-mkp/GR8975/blob/master/user_stories.md#cs-student----make-interface-more-intuitive----to-improve-user-experience

quantities, tools, measurement terms; processes; etc

In the "folio_files" directory, I don't see a .txt file for folio 3v (should be "tl_p003v.txt"). This folio DOES exist in the Ms.

Please advise.

I can't find how to enable plain text in google sheets. According to HELP, I can add a ' as in '001 to keep it from reverting to 1. seems to work...

see: https://github.com/cu-mkp/GR8975/blob/master/user_stories.md#hs-chemistry-student----search-for-chemical-ingredients-things-familiar-to-chem-students----try-them-out-for-ourselves

@VarshaMaragi I've added the translation txt files to the folio_files directory. Could you remove all the xml tags (i.e., anything matching the patter '<.+>') from the files?

1. The main problem is the ingredients of the recipe. In the folios in Google Drive, the materials in the recipes just marked by the “m” code which I assume to be materials. The instruments in the recipe are not marked as the same. However, some marked materials seems ambiguous concerning its status in the recipes. They are not ingredients, and also can not count into instruments. For example the water for soaking (p074v_2), marble used to put materials on when burnishing (p075r_2, p078v_1,p078v_4), charcoal or manual or dung used for heating (p074r_3, p076r_1, p078r_3), paper or cards used when crushing (p077r_a4), wood or tooth used, for burnishing (p074v_3, p078v_1, p078v_2).

2. Concerning the problem above, is it necessary to change the ingredients to materials, or add another category as instruments?
   When it come to the recipes on mechanism (p080r_3), and preparing sand, earth, plaster for casting(p081r), it seem that the techniques and instruments are more important than “ingredients”. “Ingredient” in each of these recipes always just include one or two, while it need to be beaten by something, soaked by water, dried by some kind of fire. These should be more important information (though not perfect fit in to the category of “instrument”) in such kinds of recipes.

3. When the ingredients in the recipe mention an alternative, should we count it as one or two?

4. How specificity should the final products be describe, the titles of the recipes sometimes indicate the final products as yellow varnish, red gum, green wood, etc. Should we just categorize them as varnish, or should we make the final products as specific as possible?

5. The end products of some medical recipes is hard to describe, like the case in p077r_a1 (wearing a lead cap or mask), p079v_2 (take something in front when working with hazardous metals).

see: https://github.com/cu-mkp/GR8975/blob/master/user_stories.md#14-casual-reader----funinteractive-interface----easy-to-use-not-much-effort-needed

@jwayno is updating all syllabi in GD, but we need to then update the GitHub version. The master syllabus version is the GD student, so each week by the time of the lab, the GitHub version needs to be updated to reflect the changes in the GD master student file.
Jeffrey - no action is needed
Mehul - for you to do weekly
Let me know if this is confusing or needs clarification.

https://github.com/cu-mkp/GR8975/blob/master/user_stories.md#9-secondary-school-teacher----digest-of-recipes----easy-to-teach-for-school

what do we mean by "read" in a digital environment?

The syllabus here is out of date: https://github.com/cu-mkp/GR8975/blob/master/README.md
We need to keep it up to date.

https://docs.google.com/spreadsheets/d/11eA8NzPmS8fL4jUtjjzIP3wHBfcbYYsJJbA6xTCqJsA/edit#gid=0

Compare existing solutions, also check Google StackDriver. Get back to Terry and Naomi.

Should we use:

1. all lower case
2. all upper case
3. mixed case

https://github.com/cu-mkp/GR8975/blob/master/user_stories.md#secondary-school-teacher----digest-of-recipes----easy-to-teach-for-school

Smith metadata sheet, fols. 1r-3r (shareable link):
https://drive.google.com/open?id=1GleRmCdEWOD7ZcfzhcE3wVRsXlC-AJoZSHqUWaASSB8

When listing ingredients in a recipe, how restrictive should I be?
One of my recipes includes:

1. a recipe for varnish with 2 ingredients, which I have included in my spreadsheet
2. commentary on the effectiveness of that varnish compared to other varnishes. The main/defining ingredient in those 'rival' varnishes is listed. Should I include ingredients in the metadata spreadsheet that are not strictly used in the recipe itself?

folio files have format # tl_.txt# but some files are named #tl_.docx.txt#
does this need fixing?

Should we agree on a delimited list of generic-category words for "activity"?
What about the more specific descriptions? Should those also be from a finite (or controlled) list?

see: https://github.com/cu-mkp/GR8975/blob/master/user_stories.md#hs-chemistry-student----search-for-chemical-ingredients-things-familiar-to-chem-students----try-them-out-for-ourselves

https://github.com/cu-mkp/GR8975/blob/master/user_stories.md#7-student----freq-of-words----compile-keywords

I need more permissions to edit GR8975 - change settings and add github pages.

in folio_images directory

I keep coming across ridiculously specific tools in my recipes (e.g., marble slabs, teeth for burnishing, etc.). These seem important to track

See also #50 : When it come to the recipes on mechanism (p080r_3), and preparing sand, earth, plaster for casting(p081r), it seem that the techniques and instruments are more important than “ingredients”. “Ingredient” in each of these recipes always just include one or two, while it need to be beaten by something, soaked by water, dried by some kind of fire. These should be more important information (though not perfect fit in to the category of “instrument”) in such kinds of recipes.

See https://github.com/cu-mkp/GR8975/blob/master/user_stories.md#fashion-desginer----end-product-of-color-related-recipes----to-see-what-they-look-like

For many of the recipes in my folios, there don't appear to be any corresponding annotations. Do we just leave these fields blank on the metadata template?

https://github.com/cu-mkp/GR8975/blob/master/user_stories.md#cs-student----make-interface-more-intuitive----to-improve-user-experience

If my recipe calls for "good chalk, quite white" and "half-burned saffron," are the ingredients "chalk" and "saffron" OR does "half-burned saffron" constitute a new ingredient? That is, when does an adjective (or other modifier) qualify an ingredient to such an extent that it should be an ingredient of its own?

This problem keeps coming up. Is "burnished silver" enough of its own thing, or is it just "silver"?

Did we decide not to include marginalia? So, where does all that data fit into the metadata sheet? It has no header, so it is not a recipe. It includes additional ingredients, but they are not necessarily integral to the recipe. Additionally, marginalia includes location on the page.

Add Alex's visit to student syllabus on markdown day

When the ingredients in the recipe mention an alternative, should we count it as one or two?

I have the following cases, which I think merit tracking:

1. A recipe that includes a "sub-recipe" describing the process of making one of the ingredients of the "main recipe"
2. A recipe that ends by referring to the next step, which is—in fact—the next recipe (so there is a relationship between the two: the second recipe relies on the first)
3. A recipe that has a header indicating two types of product (in this case, glue) and then a recipe for each kind within the same "body text" of the recipe