Azure / Azure/azure-functions-dotnet-worker

What does "for the current environment" mean

Open
#775 1 comment 0 reactions 0 assignees View on GitHub
area: http design
Dominant language
C#
Stars
466
Forks
215
Avg merge
3d 10h
Merged PRs (30d)
7

Description

# Issue Transfer

This issue has been transferred from the Azure SDK for .NET repository, [#26331](https://github.com/Azure/azure-sdk-for-net/issues/26331).

### Please be aware that @boylec is the author of the original issue and include them for any questions or replies.

## Details

This method creates a cookie with properties that have no setters.

The comment about CreateNew says it creates a cookie "for the current environment". The meaning of this is non-obvious.

The Append method's comment states: "To create a cookie, you can use the Microsoft.Azure.Functions.Worker.Http.HttpCookies.CreateNew method." This appears to be false because creating a cookie using this method doesn't appear to allow me to set the cookie's value or other attributes due to the lack of setters on the resulting IHttpCookie object.

What gives?

---
#### Document Details

⚠ *Do not edit this section. It is required for docs.microsoft.com ➟ GitHub issue linking.*

* ID: 81095906-a34f-1cef-f357-d86000f9ac0e
* Version Independent ID: 640580c2-e54e-0e75-ff39-3233a8a7b2af
* Content: [HttpCookies.CreateNew Method (Microsoft.Azure.Functions.Worker.Http) - Azure for .NET Developers](https://docs.microsoft.com/en-us/dotnet/api/microsoft.azure.functions.worker.http.httpcookies.createnew?view=azure-dotnet)
* Content Source: [xml/Microsoft.Azure.Functions.Worker.Http/HttpCookies.xml](https://github.com/Azure/azure-docs-sdk-dotnet/blob/master/xml/Microsoft.Azure.Functions.Worker.Http/HttpCookies.xml)
* GitHub Login: @rloutlaw
* Microsoft Alias: **routlaw**

Contributor guide

No contributing guide indexed for this repository

Research direction

Start with xml/Microsoft.Azure.Functions.Worker.Http/HttpCookies.xml and review the CreateNew and Append entries linked in the issue. Determine what “for the current environment” means and whether the documentation accurately describes creating and configuring a cookie. Done means the API documentation explains the behavior and resolves the apparent contradiction about cookie properties.

Written by the indexing model from the issue text.

Assessment

Tech stack
azure, csharp
Domain
documentation
Issue type
Documentation
Difficulty
4/5
Estimated time
3-5 days
Activity status
Stale
Clarity
Needs clarification
Newbie friendliness
25/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.