Stuck on an issue?

Lightrun Answers was designed to reduce the constant googling that comes with debugging 3rd party libraries. It collects links to all the places you might be looking at while hunting down a tough bug.

And, if you’re still stuck at the end, we’re happy to hop on a call to see how we can help out.

"How to build and run the latest" - Moving towards an explicit explanation....

See original GitHub issue

Issue

Obviously my position approaching this, is an outsider looking in. One looking to make contributions to this project would require a ramp-up, of which starts with How to build and run the latest.

The combination of the four steps that are outlined and how I (an outsider) perceive them, fails to produce a working dev environment. Of which, I would attribute to implicit explanations.

Breakdown

Prerequisites

Though to one it might seem obvious, things like denoting vs 2017 is a requirement is of value to others.

Step 1: Get the SDK for your platform from dotnet/cli

More explanation is needed as to what version is required and how to maintain version compatibility moving forward.
Do we need 1.0.x, 1.1.x, 2.x? Do we need RC or Alpha?

Step 2: Clone this repository to your local machine

Simple enough on the surface but details on branching strategies and expectations would go a long way.
For example, as of the date I am writing this, it appears the default branch is rel/vs2017/post-rtw.
- If the expectation is for contributes to branch off of branch-x, explicit explanation would go a long way.

Step 3: Run the setup script

Again, simple enough but results in an unclear outcome. See next step…

Step 4: That’s it! Now you can run dotnet new3

untitled-1

Running through the steps as I have viewed them, has resulted in the above.
- dotnet new --help produces expected output while dotnet new3 --help does not.

Solution

It would be of value to open up the conversation early about the process I or any other potential new contributor goes through when trying to ramp up the knowledge set needed to contribute to this project. Personally, I would be more then willing to document the knowledge gained as I progress through this process. Be that via the wiki or readme.

Issue Analytics

State:
Created 7 years ago
Comments:12 (12 by maintainers)

Top GitHub Comments

1reaction

mlorbetskecommented, Mar 29, 2017

Sounds good. Thanks @chad-ramos for writing up the detailed instructions!

0reactions

chad-ramoscommented, Mar 29, 2017

@mlorbetske - With #417 being merged, any issues with closing this “Issue”?

Top Results From Across the Web

Running an explicit dynamics simulation on a composite ...

I tried a simple drop test using the same material and was able to bring in the ACP model into Explicit Dynamics and...

Implicit and Explicit Intents in Android with Examples

Some of the general functions of intent are: Start service; Launch Activity; Display web page; Display contact list; Message broadcasting ...

Hints when switching from an explicit to an implicit deck

Speaker: Anders Jonsson (DYNAmore Nordic AB) Product development today means satisfying requirements within a variety of fields like crash ...

Best practices for writing Dockerfiles

Minimize the number of layers link · Only the instructions RUN , COPY , and ADD create layers. Other instructions create temporary intermediate...

What Does Explicit Mean? | Definition & Examples

Lesson Summary Explicit means that something is clearly stated or explained. Explicit statements are direct and easy to understand, saying exactly what they ......