Skip to content

Re-structuring of TOC#444

Open
ronnyhdez wants to merge 17 commits into
NASA-Openscapes:mainfrom
ronnyhdez:I427
Open

Re-structuring of TOC#444
ronnyhdez wants to merge 17 commits into
NASA-Openscapes:mainfrom
ronnyhdez:I427

Conversation

@ronnyhdez
Copy link
Copy Markdown
Member

Re-structuring of TOC according to co-working session: #427 (comment)

@ronnyhdez
Copy link
Copy Markdown
Member Author

/deploy-preview

@github-actions
Copy link
Copy Markdown

github-actions Bot commented May 7, 2026

@itcarroll itcarroll added this to the Restructuring Navigation milestone May 7, 2026
@ronnyhdez
Copy link
Copy Markdown
Member Author

/deploy-preview

ronnyhdez added 2 commits May 16, 2026 12:25
is not the fontawesome or bootstrap icon we were initially planning, but is an easy solution compared to change the css style or implementing html syntax in the file
@ronnyhdez ronnyhdez linked an issue May 16, 2026 that may be closed by this pull request
@ronnyhdez ronnyhdez requested a review from ateucher May 19, 2026 16:22
@ateucher
Copy link
Copy Markdown
Member

/deploy-preview

@ateucher
Copy link
Copy Markdown
Member

@ronnyhdez I triggered the deploy preview with the /deploy-preview comment. The reason it wasn't running on your subsequent commits is because your PR is from an external fork, not a branch. When that's the case, the /deploy-preview comment is necessary whenever you need to create/update the preview. See #458 to hopefully make this clearer

Copy link
Copy Markdown
Member

@ateucher ateucher left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

@ronnyhdez I think this looks great! I think you captured the structure we talked about pretty much perfectly. I have a few comments/suggestions/questions, but all pretty minor.

I don't know if we want to merge this yet, or see if we can figure out a way to deploy to a /latest endpoint first, so we don't keep changing the stable cookbook while we continue to iterate? See #439 by @itcarroll

Comment thread _quarto.yml
Comment thread _quarto.yml
Comment thread _quarto.yml
Comment thread _quarto.yml
Comment thread _quarto.yml Outdated
Comment thread _quarto.yml Outdated
Comment thread _quarto.yml
Comment thread _quarto.yml Outdated
Comment thread _quarto.yml
@ronnyhdez ronnyhdez linked an issue May 24, 2026 that may be closed by this pull request
The files will be re-classified according to its content in the next milestone
@ronnyhdez
Copy link
Copy Markdown
Member Author

/deploy-preview

@ronnyhdez
Copy link
Copy Markdown
Member Author

Hi @itcarroll, @alexishunzinger, @danielfromearth!

Here is the PR with the changes we have been discussing in the latest co-working sessions. @ateucher has already reviewed the content and I have addressed all the comments. 😄

The main intention of this PR is to capture the proposed new main sections and their contents. Most of the changes are in _quarto.yml, so the impact is mainly on the table of contents structure rather than modifying or deleting existing files.

Changes to the actual files (i.e. removing a WIP content and instead creating a new issue or a PR) would happen in the next stage.

When you have a chance, could you please take a look and let me know if you agree with this structure, or if there is anything missing or that should be changed?

Thanks!

Copy link
Copy Markdown
Contributor

@itcarroll itcarroll left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Minor change requests, but otherwise looks correct to me.

There are many links that are now incorrectly getting the external link icon, which I think is being worked on in a separate PR, but perhaps that is a preview artifact.

Comment thread _quarto.yml
href: https://nasa.github.io/ASDC_Data_and_User_Services/
- text: "NSIDC Data Cookbook"
href: https://nsidc.github.io/NSIDC-Data-Cookbook/
- text: "OBDAAC Ocean Data Cookbook"
Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
- text: "OBDAAC Ocean Data Cookbook"
- text: "OB.DAAC Help Hub"

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

The "." is important for our DAACs branding, and the "Help Hub" is the cookbook's current title. If you just want to have "OB.DAAC Tutorials", that's okay too.

Comment thread _quarto.yml
# ============================================================
# SECTION 4: HOW-TO GUIDES (goal-oriented, assumes contex)
# ============================================================
- section: "How-To Guides (goal-oriented, assumes context)"
Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
- section: "How-To Guides (goal-oriented, assumes context)"
- section: "How-To Guides (Do a Task)"

Noted in May 7 co-working notes.

Comment thread _quarto.yml
format:
html:
grid:
sidebar-width: 500px
Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Perhaps the width could be a bit less, given the shorter heading of "How-To Guides (Do a Task)".

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

3 participants