Skip to content

Add gh-pages hello world#56

Merged
tshuck-beyond merged 34 commits intomainfrom
feat-55-developer-ux-migrate-usage-documentation-to-github-pages
Feb 17, 2025
Merged

Add gh-pages hello world#56
tshuck-beyond merged 34 commits intomainfrom
feat-55-developer-ux-migrate-usage-documentation-to-github-pages

Conversation

@tshuck-beyond
Copy link
Collaborator

@tshuck-beyond tshuck-beyond commented Feb 10, 2025

Adds a github pages documentation site, available at: https://beyond-finance.github.io/feature_map/. Note: that URL represents the current site built from this branch, so you can check it out as part of review. It also updates the project's README to remove items that are now documented as part of the readme site.

This also adds bin scripts to run the doc site, and the readme site, locally. Finally, it sets the readme site as the website for this repository in github:
CleanShot 2025-02-13 at 17 49 04@2x

@tshuck-beyond tshuck-beyond marked this pull request as ready for review February 13, 2025 22:47
Copy link
Collaborator

@hstrowd hstrowd left a comment

Choose a reason for hiding this comment

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

Looks great. All comments are non-blocking. Thanks so much for putting this together. 💪

Copy link
Contributor

@DLavin23 DLavin23 left a comment

Choose a reason for hiding this comment

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

Left some small typo and phrasing related comments, but otherwise, this looks awesome. Great work!

<link rel="stylesheet" href="{{ '/tailwind.build.css' | relative_url }}">
</head>
<body>
<header class="sticky top-0 z-50 flex items-center justify-between px-3 py-2 border-b shadow-lg bg-white/90 backdrop-blur-sm border-slate-400/40">
Copy link
Contributor

Choose a reason for hiding this comment

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

In general, do we care about viewing these docs on a mobile device? I noticed we at least hide the nav, but don't make it viewable on smaller screens.

image


When you run `bin/featuremap validate`, the following files will automatically be generated:
* `.feature_map/assignments.yml`: Captures a mapping of files within a repository to their corresponding feature and a mapping of features to their corresponding files.
* `.feature_map/metrics.yml`: Captures a set of metrics rolled up at the feature level (i.e. computed over all files assigned to the feature).
Copy link
Contributor

Choose a reason for hiding this comment

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

Depending on which gets merged first, we mighit need to add the additional-metrics.yml file from #57

- Generated by [`bin/featuremap test_coverage`]({{ '/interface/test-coverage' | relative_url }})
- Stores per-Feature aggregated test coverage data from codecov
- Optional
- `.feature_map/test-pyramid.yml`
Copy link
Contributor

Choose a reason for hiding this comment

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

Similar comment, once #57 gets merged, I think we'll want this to reference the .feature_map/additional-metrics.yml

@tshuck-beyond tshuck-beyond merged commit 3c090e3 into main Feb 17, 2025
10 checks passed
@tshuck-beyond tshuck-beyond deleted the feat-55-developer-ux-migrate-usage-documentation-to-github-pages branch February 17, 2025 20:13
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants