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

[Network] Refine Quarto Website for Network Documentation #24

Open
4 tasks done
njlyon0 opened this issue Nov 18, 2024 · 4 comments
Open
4 tasks done

[Network] Refine Quarto Website for Network Documentation #24

njlyon0 opened this issue Nov 18, 2024 · 4 comments
Assignees
Labels
network-office LTER Network Office (LNO) tasks

Comments

@njlyon0
Copy link
Member

njlyon0 commented Nov 18, 2024

Summary

Discussed creating a Quarto-based website for Network documentation (and possibly some non-sensitive LNO documentation). spin up the website repo with a bare-bones site to start then begin porting documentation in from elsewhere into that scaffold

Starting Tasks

  • Make new repo from WG template repo
  • Spin up simple / empty Quarto website
    • With relevant GHA set up so edits to docs automatically re-render the website without user interaction
  • Migrate IM manual content into that website
    • See the current IM manual content here
  • Discuss next steps with Marty

Useful links

@njlyon0 njlyon0 added the network-office LTER Network Office (LNO) tasks label Nov 18, 2024
@njlyon0 njlyon0 self-assigned this Nov 18, 2024
@njlyon0 njlyon0 moved this to Active Progress in Scientific Computing Tasks Nov 18, 2024
@njlyon0
Copy link
Member Author

njlyon0 commented Nov 18, 2024

Empty Website Deployed

Skeleton of website with a single page (homepage) deployed on this repo. GitHub Action working as desired so ready to move on to following sub-tasks

@njlyon0
Copy link
Member Author

njlyon0 commented Nov 19, 2024

IM Content Migrated

Migrated over all of the IM manual content and pinged Marty for review/feedback. Migration was basically painless because everything was already in a markdown file so copy/pasting into a Quarto file required only minor subsequent repairs.

@njlyon0 njlyon0 moved this from Active Progress to Pending in Scientific Computing Tasks Nov 19, 2024
@njlyon0 njlyon0 moved this from Pending to Active Progress in Scientific Computing Tasks Dec 2, 2024
@njlyon0 njlyon0 changed the title [Network] Create Quarto Website for Network Documentation [Network] Refine Quarto Website for Network Documentation Dec 2, 2024
@njlyon0
Copy link
Member Author

njlyon0 commented Dec 2, 2024

Next Steps Identified

Met with Marty to discuss current progress / next steps and identified some new sub-tasks for me to work on.

  • Revise GitHub org recommendations to reflect current best practices / etc.
  • Add scaffolding to website for following groups (incl. dropdown menu and 'under construction' home page for each)
    • PIs
    • Education
    • Broadening Participation (née DEIJ)
    • Graduate
  • Reach out to Gabe De La Rosa about Grad interest in making their docs public / being able to edit the website directly
  • Ping MD for review

@njlyon0
Copy link
Member Author

njlyon0 commented Dec 10, 2024

Pinged MD

Schedule sent an email to MD (she's at AGU this week) with an update on current progress and request for feedback. Moving this to the 'pending' category until I get word back

@njlyon0 njlyon0 moved this from Active Progress to Pending in Scientific Computing Tasks Dec 10, 2024
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
network-office LTER Network Office (LNO) tasks
Projects
Development

No branches or pull requests

1 participant