Hacktoberfest 2026: the issues maintainers tagged for October, open and beginner-friendly. Browse Hacktoberfest issues

Update copilot-instructions: allow return value documentation

Open Beginner friendly
#12 0 comments 0 reactions 0 assignees View on GitHub

Maintainers usually reply within 1 day

Nobody has claimed this yet.

Assessment

Difficulty
1/5
Estimated time
Under an hour
Newbie friendliness
78/100
Issue type
Documentation
Clarity
Clearly specified
Activity status
Quiet
Tech stack
csharp
Domain
documentation

Research direction

Open .github/copilot-instructions.md and locate the rule that prohibits documenting return values. Remove that rule while preserving the surrounding instructions; done means the file no longer forbids return-value documentation. No test or run command is mentioned in the issue.

Written by the indexing model from the issue text.

Description

enhancement

Problem

The .github/copilot-instructions.md currently says "Do NOT document return values" (no <returns> tag). This convention is inherited from the internal BPM repo and is inappropriate for a public samples repository where XML docs help developers understand the code.

Proposed Changes

  1. Update .github/copilot-instructions.md to remove the "Do NOT document return values" rule

Context

The Samples repo has minimal public API surface, so the code change scope is small — primarily the copilot-instructions update.

See also: Azure/Connectors-NET-SDK#41

Dominant language
C#
Stars
3
Forks
3
Avg merge
58m
Merged PRs (30d)
3

Getting set up

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

More from Azure/Connectors-NET-Samples

All issues in Azure/Connectors-NET-Samples

Similar issues

More C# issues

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.