Skip to content

For Lecturers

Jump to bottom
admin edited this page Jun 29, 2026 · 1 revision

For Lecturers

Home · About-MedBioPhys · Support · Frequently-Asked-Questions

Guidance for UMB staff and lecturers who publish or review MedBioPhys content. Students: use Support to report errors.

What lecturers need to know

Student-facing pages come from the public content repository:

github.com/GKulesza/medbiophys-content

The app includes a bundled copy for offline use. When students are online, it downloads files listed in manifest.json.

Important: editing a markdown or JSON file alone is not enough. The manifest must list new checksums and version numbers, or installed apps will not receive the update.

How content reaches the app

  Markdown / JSON          ← you edit news, staff, regulations, etc.
         ↓
  publish_content.py       ← maintainer runs the publish pipeline
         ↓
  manifest.json            ← records file hashes and versions
         ↓
  GitHub (main branch)     ← medbiophys-content repository
         ↓
  Student application      ← syncs when online; offline fallback otherwise

If manifest.json is out of date, students keep seeing the old file even though GitHub shows your edit.

Content domains

Domain Typical files Updates via sync
News news/{locale}/feed.json Yes
History history/{locale}/history.md Yes
About about/{locale}/about.md Yes
Contact contact/{locale}/contact.md Yes
Staff staff/{locale}/staff.json Yes
Resources resources/{programme}/{locale}/resources.json Yes
Regulations regulations/{programme}/{locale}/*.md Yes
Schedules App release No — requires new app version
LearnMap App release No — requires new app version
Practice tasks App release No — requires new app version

Editorial locales: en, pl, es, eo, isv, isv_cyrl, isv_glag.

Recommended workflow

With application maintainers (preferred)

  1. Describe the change (news item, regulation fix, staff update).
  2. Maintainers edit files and run publish_content.py.
  3. Updated files and manifest.json are pushed to medbiophys-content main.
  4. Students force-quit the app, reopen online, and use the matching UI language for locale-specific news.

Editing GitHub directly

Update both:

  1. The content file (for example news/pl/feed.json)
  2. manifest.json — new sha256, sizeBytes, and higher version for that entry

Verify the manifest matches live files:

https://raw.githubusercontent.com/GKulesza/medbiophys-content/main/manifest.json

News by language

Feed Visible when app language is
news/pl/feed.json Polish
news/en/feed.json English
news/es/feed.json Spanish
(same pattern) Esperanto, Interslavic, etc.

A Polish-only edit will not appear for students using English UI.

Regulations and syllabi

Programme folders use slugs such as english_division, lekarski, and pielegniarstwo. Each may include regulations.md, syllabus.md, safety.md, exam.md, faq.md, and assessment.md per locale.

Coordinate with the department before changing official legal text.

What requires an app store update

These cannot reach students through content sync today:

  • LearnMap exercises or titles
  • Practice tasks
  • Calendar schedules
  • New programmes in the picker
  • App UI translations

Plan these with the development team before announcing dates to students.

Checklist before publish

  • Correct locale folder edited
  • Valid JSON or markdown
  • manifest.json updated on main
  • Test device: correct language, force-quit, online reopen
  • Images use repository paths (not raw https:// in markdown image tags)

Licensing

Editorial files in medbiophys-content are under the MIT License. Do not upload copyrighted material without permission.

Contact

Role Contact
Department biofizyka@umb.edu.pl
App and publish pipeline etaosin@gmail.com

See also

Clone this wiki locally