Skip to content
New issue

Have a question about this project? # for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “#”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? # to your account

Index API and AvalancheGo Configs Docs Fix #3632

Merged
merged 9 commits into from
Jan 7, 2025
Merged

Conversation

meaghanfitzgerald
Copy link
Contributor

Why this should be merged

Many broken links exist in these docs, and the "configs" doc is hard to navigate due to a lack of order

How this works

Edited /indexer/service.go and config/config.md

How this was tested

previewed in code editor. Changes will be visible on docs.avax.network after this PR is merged and the docs build is triggered.

Need to be documented in RELEASES.md?

no

config/config.md Outdated
Comment on lines 266 to 267
```go
{
Copy link
Contributor

Choose a reason for hiding this comment

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

Hmm, so if this is trying to look like a json definition, I think we would want the tabs/spaces right?

Copy link
Contributor Author

Choose a reason for hiding this comment

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

my md linter hated the tab, code block was also labelled ```go. fixed

config/config.md Outdated
@@ -263,122 +263,122 @@ As an alternative to `--db-config-file`, it allows specifying base64 encoded dat
A LevelDB config file must be JSON and may have these keys.
Any keys not given will receive the default value.

```go
```json
Copy link
Contributor

Choose a reason for hiding this comment

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

This isn't valid json either (and the github visual of this block does not like that it is marked as json)

Copy link
Contributor Author

Choose a reason for hiding this comment

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

it's not a valid json because of the comments? either way this doc is completely non functional. Would rather please .md standards than GH because this doc is hosted on our dev docs

Copy link
Contributor

Choose a reason for hiding this comment

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

Maybe have it as text? 🤔 Maybe json gets rendered as extended json depending on the rendering engine...

Copy link
Contributor Author

Choose a reason for hiding this comment

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

text removes all color-coding which makes it a bit harder to read.
image

Copy link
Contributor Author

Choose a reason for hiding this comment

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

I readded the tab and set the codeblock back to go.

Copy link
Contributor Author

Choose a reason for hiding this comment

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

…andling (#3574)

Signed-off-by: aaronbuchwald <aaron.buchwald56@gmail.com>
Signed-off-by: Meaghan FitzGerald <meag.fitz@avalabs.org>
Co-authored-by: Stephen Buttolph <stephen@avalabs.org>
Co-authored-by: Meaghan FitzGerald <meag.fitz@avalabs.org>
@StephenButtolph StephenButtolph added this pull request to the merge queue Jan 7, 2025
Merged via the queue into master with commit 80b82e8 Jan 7, 2025
22 checks passed
@StephenButtolph StephenButtolph deleted the api-docs-edits branch January 7, 2025 15:53
tsachiherman pushed a commit that referenced this pull request Jan 29, 2025
Signed-off-by: aaronbuchwald <aaron.buchwald56@gmail.com>
Signed-off-by: Meaghan FitzGerald <meag.fitz@avalabs.org>
Co-authored-by: aaronbuchwald <aaron.buchwald56@gmail.com>
Co-authored-by: Stephen Buttolph <stephen@avalabs.org>
# for free to join this conversation on GitHub. Already have an account? # to comment
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

5 participants