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

feat(.NET): Consolidating APIs #17266

Open
wants to merge 12 commits into
base: develop
Choose a base branch
from
Open

Conversation

jeff-colucci
Copy link
Contributor

No description provided.

@jeff-colucci jeff-colucci added content requests related to docs site content from_tw Identifies issues/PRs from Tech Docs writers labels May 10, 2024
@jeff-colucci jeff-colucci self-assigned this May 10, 2024
@github-actions github-actions bot added this to Hero to triage in Docs PRs and Issues May 10, 2024
Copy link

Hi @jeff-colucci 👋

Thanks for your pull request! Your PR is in a queue, and a writer will take a look soon. We generally publish small edits within one business day, and larger edits within three days.

We will automatically generate a preview of your request, and will comment with a link when the preview is ready (usually 10 to 20 minutes).

Copy link

netlify bot commented May 10, 2024

Deploy Preview for docs-website-netlify ready!

Name Link
🔨 Latest commit ea7a294
🔍 Latest deploy log https://app.netlify.com/sites/docs-website-netlify/deploys/6650d9ec444b03000873527f
😎 Deploy Preview https://deploy-preview-17266--docs-website-netlify.netlify.app
📱 Preview on mobile
Toggle QR Code...

QR Code

Use your smartphone camera to open QR code link.

To edit notification comments on pull requests, go to your Netlify site configuration.

@akristen akristen moved this from Hero to triage to Drafts in Docs PRs and Issues May 10, 2024
@jeff-colucci jeff-colucci changed the title feat(Dotnet): Consolodating APIs feat(Dotnet): Consolidating APIs May 15, 2024
@jeff-colucci jeff-colucci changed the title feat(Dotnet): Consolidating APIs feat(.NET): Consolidating APIs May 21, 2024
@jeff-colucci jeff-colucci marked this pull request as ready for review May 22, 2024 15:35
removing superfluous callout
@jeff-colucci jeff-colucci moved this from Drafts to Needs review in Docs PRs and Issues May 22, 2024
@jeff-colucci
Copy link
Contributor Author

@austin-schaefer austin-schaefer requested review from austin-schaefer and removed request for bradleycamacho May 22, 2024 22:13
Copy link
Collaborator

@austin-schaefer austin-schaefer left a comment

Choose a reason for hiding this comment

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

Hey Jeff, just finished a review. I found three types of things to address:

  • Various rendering / structural things (visible anchor ID, missing collapser tags, tables-in-tables) that should be fixed before merge
  • We need to account for existing links to these pages. Some of those are links w/in the page, but we should also account for existing links to individual methods in other docs that will break. We can create a separate Jira for that sweep but let's ensure we don't let it fall thru the cracks.
  • Non-fatals: I found a lot of style/grammar/formattng errors and inconsistencies. I suspect many of those were pre-existing in the source docs, and I don't think we need to get these to 100%. But I'd like to fix the low-hanging fruit while we're working on this

- Agents
- NET agent
- API guides
metaDescription: 'A goal-focused guide to the New Relic .NET agent API.'
Copy link
Collaborator

Choose a reason for hiding this comment

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

This meta-description feels outdated for the current scope of the doc.

- /docs/agents/net-agent/net-agent-api/tracemetadata-net-agent-api-0
- /docs/apm/agents/net-agent/net-agent-api/tracemetadata-net-agent-api-0

freshnessValidatedDate: never
Copy link
Collaborator

Choose a reason for hiding this comment

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

This should be updated


New Relic's .NET agent includes an API that allows you to extend the agent's standard functionality. For example, you can use the .NET agent API for:

* Customizing your app name
Copy link
Collaborator

Choose a reason for hiding this comment

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

Unnecessary -ing verbs

freshnessValidatedDate: never
---

New Relic's .NET agent includes an API that allows you to extend the agent's standard functionality. For example, you can use the .NET agent API for:
Copy link
Collaborator

Choose a reason for hiding this comment

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

Suggested change
New Relic's .NET agent includes an API that allows you to extend the agent's standard functionality. For example, you can use the .NET agent API for:
New Relic's .NET agent includes an API that allows you to extend the agent's standard functionality. For example, you can use the .NET agent API to:

To use the .NET agent API, make sure you have the [latest .NET agent release](/docs/release-notes/agent-release-notes/net-release-notes). Then, add a reference to the agent in your project using one of the two options below:

* Add a reference to `NewRelic.Api.Agent.dll` to your project.
OR
Copy link
Collaborator

Choose a reason for hiding this comment

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

I think this needs an extra line break or something to show up on its own line, in preview it shows up on same line

Uploading image.png…

</tbody>
</table>

### NoticeError(String, IDictionary, bool) [#string-idictionary-bool-overload]
Copy link
Collaborator

Choose a reason for hiding this comment

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

should this be its own collapser?

<Callout variant="important">
* Sending a lot of events can increase the memory overhead of the agent.
* Additionally, posts greater than 1MB (10^6 bytes) in size will not be recorded regardless of the maximum number of events.
* Custom Events are limited to 64-attributes.
Copy link
Collaborator

Choose a reason for hiding this comment

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

Suggested change
* Custom Events are limited to 64-attributes.
* Custom events are limited to 64 attributes.

Caps and hyphen here are weird


### Requirements

* Agent version 5.0.136.0 or higher.
Copy link
Collaborator

Choose a reason for hiding this comment

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


This API call is compatible with:

* Agent versions >= 10.9.0
Copy link
Collaborator

Choose a reason for hiding this comment

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

Other calls say "or higher" rather than use puncutation


### Requirements

* Agent version 5.0.136.0 or higher.
Copy link
Collaborator

Choose a reason for hiding this comment

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

Same version comment as previous, this is EOl version

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
content requests related to docs site content from_tw Identifies issues/PRs from Tech Docs writers
Projects
Development

Successfully merging this pull request may close these issues.

None yet

2 participants