dotnet/EntityFramework.Docs

Consider linking connection resiliency topics with SQL Server/SQL Azure DB docs

Open

#361 opened on Mar 6, 2017

View on GitHub
 (1 comment) (0 reactions) (0 assignees)PowerShell (1,961 forks)batch import
area-connection-resiliencygood first issue

Repository metrics

Stars
 (1,625 stars)
PR merge metrics
 (Avg merge 1d 18h) (18 merged PRs in 30d)

Description

Currently the topics https://docs.microsoft.com/en-us/ef/core/miscellaneous/connection-resiliency and https://docs.microsoft.com/en-us/azure/sql-database/sql-database-connectivity-issues are completely disconnected, however customers need to often interact with settings on both layers of the stack.

Having these topics link to each other would be useful to those customers.

There is also probably some more detailed guidance we need to figure out, i.e. if there are settings that should not be used together.

Notice that the latter is maintained at https://github.com/Microsoft/azure-docs/blob/master/articles/sql-database/sql-database-connectivity-issues.md and we could send a PR.

cc @AndriySvyryd @ajcvickers @ErikEJ

Contributor guide

Research direction
Review the two documentation pages mentioned in the issue: the EF Core connection resiliency doc at https://docs.microsoft.com/en us/ef/core/miscellaneous/connection resiliency and the Azure SQL connectivity issues doc at https://docs.microsoft.com/en us/azure/sql database/sql database connectivity issues. Additionally, the Azure docs source is at https://github.com/Microsoft/azure docs/blob/master/articles/sql database/sql database connectivity issues.md. Consider adding cross links between these pages and possibly providing guidance on settings that should not be used together.
Tech stack
csharpsql
Domain
documentation
Issue type
Documentation
DifficultyEstimated implementation difficulty for a new contributor, from 1 for very small changes to 5 for expert-level work.
2
Estimated timeA rough time range for an experienced contributor to investigate, implement, test, and prepare a pull request.
Under 1 hour
Activity statusHow available the issue appears right now: fresh, active, stale, blocked, or waiting on maintainer input.
Stale
ClarityHow clearly the issue explains the expected change, acceptance criteria, and next step.
Clear
Prerequisites
Basic understanding of Entity Framework CoreFamiliarity with Azure SQL Database
Newbie friendlinessA 1-100 score estimating how approachable this issue is for first-time contributors.
85