Skip to content

Commit 4ebf3c8

Browse files
committed
Added md files
1 parent dcfea8f commit 4ebf3c8

File tree

3 files changed

+67
-2
lines changed

3 files changed

+67
-2
lines changed

Readme.txt Installation.md

+9-2
Original file line numberDiff line numberDiff line change
@@ -1,4 +1,5 @@
11
How to use the source code:
2+
23
- Before opening the solution, run the RestorePackages.bat file
34

45
Explanation:
@@ -8,13 +9,16 @@ How to use the source code:
89

910
How to debug the extension:
1011
IMPORTANT: Uninstall the "Exceptional" extension first
12+
1113
1. Open the "Properties" of the "Exceptional" project in the solution
1214
2. Go to the "Debug" section, select "Debug" as configuration and change the following settings:
1315
- Start external program: Select your Visual Studio application "devenv.exe"
1416
- Command line arguments:
15-
/ReSharper.Plugin "PATH/TO/SOURCES/Exceptional/bin/Debug/ReSharper.Exceptional.dll"
17+
18+
/ReSharper.Plugin "PATH/TO/SOURCES/Exceptional/bin/Debug/ReSharper.Exceptional.dll"
1619

1720
How to release a new version:
21+
1822
1. Update extension version in Exceptional.nuspec and AssemblyInfo.cs if necessary
1923
2. Rebuild the whole solution in "Release" configuration
2024
3. Run NuGet/Build.bat
@@ -23,9 +27,12 @@ How to release a new version:
2327
6. Push changes (also new NuGet package) to Git
2428

2529
What to look for in pull requests:
30+
2631
- Check with community if feature makes sense
2732
- Check that the changes do not decrease performance (this is very important!)
2833

2934
Log files to find problem why exception crashed:
35+
3036
- The ReSharper log files can be found here:
31-
C:\Users\USERNAME\AppData\Local\JetBrains\ReSharper\v8.2\ExceptionStorage
37+
38+
C:\Users\USERNAME\AppData\Local\JetBrains\ReSharper\v8.2\ExceptionStorage

LICENSE.md

+34
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,34 @@
1+
# Microsoft Public License (Ms-PL)
2+
3+
This license governs use of the accompanying software. If you use the software, you accept this license. If you do not accept the license, do not use the software.
4+
5+
1\. Definitions
6+
7+
The terms "reproduce," "reproduction," "derivative works," and "distribution" have the same meaning here as under U.S. copyright law.
8+
9+
A "contribution" is the original software, or any additions or changes to the software.
10+
11+
A "contributor" is any person that distributes its contribution under this license.
12+
13+
"Licensed patents" are a contributor's patent claims that read directly on its contribution.
14+
15+
2\. Grant of Rights
16+
17+
(A) Copyright Grant- Subject to the terms of this license, including the license conditions and limitations in section 3, each contributor grants you a non-exclusive, worldwide, royalty-free copyright license to reproduce its contribution, prepare derivative works of its contribution, and distribute its contribution or any derivative works that you create.
18+
19+
(B) Patent Grant- Subject to the terms of this license, including the license conditions and limitations in section 3, each contributor grants you a non-exclusive, worldwide, royalty-free license under its licensed patents to make, have made, use, sell, offer for sale, import, and/or otherwise dispose of its contribution in the software or derivative works of the contribution in the software.
20+
21+
3\. Conditions and Limitations
22+
23+
(A) No Trademark License- This license does not grant you rights to use any contributors' name, logo, or trademarks.
24+
25+
(B) If you bring a patent claim against any contributor over patents that you claim are infringed by the software, your patent license from such contributor to the software ends automatically.
26+
27+
(C) If you distribute any portion of the software, you must retain all copyright, patent, trademark, and attribution notices that are present in the software.
28+
29+
(D) If you distribute any portion of the software in source code form, you may do so only under this license by including a complete copy of this license with your distribution. If you distribute any portion of the software in compiled or object code form, you may only do so under a license that complies with this license.
30+
31+
(E) The software is licensed "as-is." You bear the risk of using it. The contributors give no express warranties, guarantees or conditions. You may have additional consumer rights under your local laws which this license cannot change. To the extent permitted under your local laws, the contributors exclude the implied warranties of merchantability, fitness for a particular purpose and non-infringement.
32+
33+
34+

README.md

+24
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,24 @@
1+
# Exceptional for ReSharper
2+
3+
Exceptional is an extension for ReSharper which analyzes thrown and documented C# exceptions and suggests improvements.
4+
5+
## Motivation
6+
7+
When working with a code base - whether it is a small one or a big one - developers constantly encounter issues caused by wrong exception handling. There may be an excellent exception handling policy, but it is the developer who must execute this policy on its own code. Even with no policy defined, there are good practices on how to properly handle exceptions. This extension allows you to seamlessly apply these good practices with a couple of key strokes.
8+
9+
Generally, the public API should be documented and thrown exceptions should be part of this documentation. But even if documenting thrown exceptions is pretty easy, the maintenance of the code that is using a particular method or property is not. This is where this extension comes into play: The extension analyzes call sites and provides hints on exceptions thrown from that invocations. If an exception is either not caught or not documented then you will be proposed to fix this problem. The extension also checks other good practices, for example that an inner exception is provided when rethrowing a new exception.
10+
11+
## Installation
12+
13+
Requires ReSharper v8.2 or v9
14+
15+
- Open the ReSharper menu in Visual Studio and select Extension Manager...
16+
- Search for Exceptional and install the extension
17+
18+
Open the menu ReSharper / Options... / Exceptional to configure the extension.
19+
20+
Check out the extension in the ReSharper plugin gallery:
21+
22+
- Exceptional for ReSharper 8 in the plugin gallery
23+
- Exceptional for ReSharper 9 in the plugin gallery
24+
- Exceptional for ReSharper 10 in the plugin gallery

0 commit comments

Comments
 (0)