Skip to content

Commit abda35a

Browse files
committed
Updated changelog, added standard md files
1 parent 472a7cd commit abda35a

11 files changed

+79
-27
lines changed

AUTHORS.md

Lines changed: 7 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,7 @@
1+
# Authors
2+
3+
AirSim was originally created by [Shital Shah](https://github.com/sytelus) during late 2016. Shital authored physics engine, multirotor model, car model, environment models, sensor models, all Unreal Engine related code, APIs, SimpleFlight firmware, computer vision components, documentation etc.
4+
5+
[Chris Lovett](https://github.com/lovettchris), another original author, contributed the MavLink communication library, PX4 related components, Settings system, build system, several important bug fixes and so on.
6+
7+
List of all contributors since our first release in February 2017 can be [found here](https://github.com/Microsoft/AirSim/graphs/contributors).

docs/whats_new.md renamed to CHANGELOG.md

Lines changed: 18 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,23 @@
11
# What's new
22

3-
Below is highly summerized curated list of important changes. This does not include minor/less important changes or bug fixes or things like documentation update. This list updated every few months. For full list of changes, please review [commit history](https://github.com/Microsoft/AirSim/commits/master).
3+
Below is summarized list of important changes. This does not include minor/less important changes or bug fixes or documentation update. This list updated every few months. For complete detailed changes, please review [commit history](https://github.com/Microsoft/AirSim/commits/master).
4+
5+
### November, 2018
6+
* [New environments](https://github.com/Microsoft/AirSim/releases/tag/v1.2.1): Forest, Plains (windmill farm), TalkingHeads (human head simulation), TrapCam (animal detection via camera)
7+
* Highly efficient [NoDisplay view mode](https://github.com/Microsoft/AirSim/blob/master/docs/settings.md#viewmode) to turn off main screen rendering so you can capture images at high rate
8+
* [Enable/disable sensors](https://github.com/Microsoft/AirSim/pull/1479) via settings
9+
* [Lidar Sensor](docs/lidar.md)
10+
* [Support for Flysky FS-SM100 RC](https://github.com/Microsoft/AirSim/commit/474214364676b6631c01b3ed79d00c83ba5bccf5) USB adapter
11+
* Case Study: [Formula Student Technion Driverless](https://github.com/Microsoft/AirSim/wiki/technion)
12+
* [Multi-Vehicle Capability](docs/multi_vehicle.md)
13+
* [Custom speed units](https://github.com/Microsoft/AirSim/pull/1181)
14+
* [ROS publisher](https://github.com/Microsoft/AirSim/pull/1135)
15+
* [simSetObjectPose API](https://github.com/Microsoft/AirSim/pull/1161)
16+
* [Character Control APIs](https://github.com/Microsoft/AirSim/blob/master/PythonClient/airsim/client.py#L137) (works on TalkingHeads binaries in release)
17+
* [Arducopter Solo Support](https://github.com/Microsoft/AirSim/pull/1387)
18+
* [Linux install without sudo access](https://github.com/Microsoft/AirSim/pull/1434)
19+
* [Kinect like ROS publisher](https://github.com/Microsoft/AirSim/pull/1298)
20+
421

522
### June, 2018
623
* Development workflow doc
Lines changed: 17 additions & 15 deletions
Original file line numberDiff line numberDiff line change
@@ -1,15 +1,17 @@
1-
# Contributing
2-
3-
## How To
4-
5-
- Please read our [short and sweet coding guidelines](coding_guidelines.md).
6-
- For big changes such as adding new feature or refactoring, [file an issue first](https://github.com/Microsoft/AirSim/issues). We should talk!
7-
- Use our [recommended development workflow](dev_workflow.md) to make changes and test it.
8-
- Use [usual steps](https://akrabat.com/the-beginners-guide-to-contributing-to-a-github-project/) to make contributions just like other GitHub projects. If you are not familiar with Git Branch-Rebase-Merge workflow, please [read this first](http://shitalshah.com/p/git-workflow-branch-rebase-squash-merge/).
9-
10-
## Do and Don't
11-
- Rebase your branch frequently with master (once every 2-3 days is ideal).
12-
- Use same style and formatting as rest of code even if it's not your preferred one.
13-
- Change any documentation that goes with code changes.
14-
- Do not include OS specific header files.
15-
- Keep your pull request small, ideally under 10 files.
1+
# Contributing
2+
3+
## Quick Start
4+
- Please read our [short and sweet coding guidelines](coding_guidelines.md).
5+
- For big changes such as adding new feature or refactoring, [file an issue first](https://github.com/Microsoft/AirSim/issues).
6+
- Use our [recommended development workflow](dev_workflow.md) to make changes and test it.
7+
- Use [usual steps](https://akrabat.com/the-beginners-guide-to-contributing-to-a-github-project/) to make contributions just like other GitHub projects. If you are not familiar with Git Branch-Rebase-Merge workflow, please [read this first](http://shitalshah.com/p/git-workflow-branch-rebase-squash-merge/).
8+
9+
## Checklist
10+
- Use same style and formatting as rest of code even if it's not your preferred one.
11+
- Change any documentation that goes with code changes.
12+
- Do not include OS specific header files or new 3rd party dependencies.
13+
- Keep your pull request small, ideally under 10 files.
14+
- Make sure you don't include large binary files.
15+
- When adding new includes, make dependency is absolutely necessary.
16+
- Rebase your branch frequently with master (once every 2-3 days is ideal).
17+
- Make sure your code would compile on Windows, Linux and OSX.

ISSUE_TEMPLATE.md

Lines changed: 16 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1,4 +1,18 @@
1-
If you are looking for a new feature or bug fix, fire up your IDE, try playing around with source code and contribute back!
2-
What's better than filing issue? Filing a pull request :).
1+
# Read This First
2+
3+
## If you are reporting a bug
4+
* Make sure to write **all reproduction steps**
5+
* Include full error message in text form
6+
* Search issues for error message before filing issue
7+
* Attach screenshot if applicable
8+
* Include code to run if applicable
9+
10+
## If you have question
11+
* Add clear and concise title
12+
* Add OS, AirSim version, Python version, Unreal version if applicable
13+
* Include context on what you are trying to achieve
14+
* Include details of what you already did to find answers
15+
16+
**What's better than filing issue? Filing a pull request :).**
317

418
------------------------------------ (Remove above before filing the issue) ------------------------------------

README.md

Lines changed: 10 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -17,11 +17,17 @@ Cars in AirSim
1717

1818
## What's New
1919

20-
* AirSim is now full featured for [multiple vehicles](docs/multi_vehicle.md)!
20+
* [New environments](https://github.com/Microsoft/AirSim/releases/tag/v1.2.1): Forest, Plains (windmill farm), TalkingHeads (human head simulation), TrapCam (animal detection via camera)
21+
* Highly efficient [NoDisplay view mode](https://github.com/Microsoft/AirSim/blob/master/docs/settings.md#viewmode) to turn off main screen rendering so you can capture images at high rate
22+
* [Lidar Sensor](docs/lidar.md)
23+
* Case Study: [Formula Student Technion Driverless](https://github.com/Microsoft/AirSim/wiki/technion)
24+
* [Multi-Vehicle Capability](docs/multi_vehicle.md)
25+
* [ROS publisher](https://github.com/Microsoft/AirSim/pull/1135)
26+
* [Arducopter Solo Support](https://github.com/Microsoft/AirSim/pull/1387)
2127
* AirSim 1.2 is released! **This version has breaking changes in APIs and settings.json.** Please see the [API Upgrade](docs/upgrade_apis.md) and [Settings Upgrade](docs/upgrade_settings.md) docs.
2228
* We have upgraded to Unreal Engine 4.18 and Visual Studio 2017 (see [upgrade instructions](docs/unreal_upgrade.md))
2329

24-
For complete list of changes, view our [Changelog](docs/whats_new.md)
30+
For complete list of changes, view our [Changelog](CHANGELOG.md)
2531

2632
## How to Get It
2733

@@ -101,8 +107,8 @@ Please take a look at [open issues](https://github.com/microsoft/airsim/issues)
101107

102108
* [More on AirSim design](docs/design.md)
103109
* [More on code structure](docs/code_structure.md)
104-
* [Contribution Guidelines](docs/contributing.md)
105-
110+
* [Contribution Guidelines](CONTRIBUTING.md)
111+
* [Trello Board](https://trello.com/b/1t2qCeaA/wishlist-by-community-for-community)
106112

107113
### Who is Using AirSim?
108114

SUPPORT.md

Lines changed: 6 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,6 @@
1+
# Support
2+
3+
We highly recommend to take a look at source code and contribute to the project. Due to large number of incoming feature request we may not be able to get to your request in your desired timeframe. So please [contribute](CONTRIBUTING.md) :).
4+
5+
* [Join AirSim Facebook Group](https://www.facebook.com/groups/1225832467530667/)
6+
* [File GitHub Issue](https://github.com/Microsoft/AirSim/issues)

docs/apis.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -4,7 +4,7 @@
44
AirSim exposes APIs so you can interact with vehicle in the simulation programmatically. You can use these APIs to retrieve images, get state, control the vehicle and so on.
55

66
## Python Quickstart
7-
If you want to use Python to call AirSim APIs, we recommend using Anaconda with Python 3.5 or later versions however some code may also work with Python 2.7 ([help us](contributing.md) improve compatibility!).
7+
If you want to use Python to call AirSim APIs, we recommend using Anaconda with Python 3.5 or later versions however some code may also work with Python 2.7 ([help us](../CONTRIBUTING.md) improve compatibility!).
88

99
First install this package:
1010

docs/code_structure.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -26,7 +26,7 @@ DroneShell demonstrates how to connect to the simulator using UDP. The simulato
2626

2727
## Contributing
2828

29-
See [Contribution Guidelines](docs/contributing.md)
29+
See [Contribution Guidelines](../CONTRIBUTING.md)
3030

3131
## Unreal Framework
3232

docs/create_issue.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -18,6 +18,6 @@ AirSim is open source project and contributors like you keeps it going. It is im
1818
* Do not use "Please help" etc in the title. See above.
1919
* Do not copy and paste screen shot of error message. Copy and paste text.
2020
* Do not use "it doesn't work". Precisely state what is the error message or symptom.
21-
* Do not ask to write code for you. [Contribute](https://github.com/Microsoft/AirSim/blob/master/docs/contributing.md)!
21+
* Do not ask to write code for you. [Contribute](../CONTRIBUTING.md)!
2222

2323

docs/release_notes.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
# Release Notes
22

3-
**Please see [What's new](whats_new.md). This page is not maintained currently.**
3+
**Please see [changelog](CHANGELOG.md). This page is not maintained currently.**
44

55

66
## v1.1 - 2017-09-28

docs/use_precompiled.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -7,7 +7,7 @@ You can simply download precompiled binaries and run to get started immediately.
77
**Linux**: Binaries for Ubuntu 16.04 LTS is coming soon. For now you will need to [build it on Linux](build_linux.md) yourself.
88

99
## Controlling Vehicles
10-
Most of our users typically use [APIs](apis.md) to control the vehicles. However if you can also control vehicles manually. You can drive the car using keyboard, gamepad or [steering wheel](steering_wheel_installation.md). To fly drone manually, you will need either XBox controller or a remote control (feel free to [contribute](contributing.md) keyboard support). Please see [remote control setup](remote_control.md) for more details. Alternatively you can use [APIs](apis.md) for programmatic control or use so-called [Computer Vision mode](image_apis.md) to move around in environment using the keyboard.
10+
Most of our users typically use [APIs](apis.md) to control the vehicles. However if you can also control vehicles manually. You can drive the car using keyboard, gamepad or [steering wheel](steering_wheel_installation.md). To fly drone manually, you will need either XBox controller or a remote control (feel free to [contribute](../CONTRIBUTING.md) keyboard support). Please see [remote control setup](remote_control.md) for more details. Alternatively you can use [APIs](apis.md) for programmatic control or use so-called [Computer Vision mode](image_apis.md) to move around in environment using the keyboard.
1111

1212
## Don't Have Good GPU?
1313
The AirSim binaries, like CityEnviron, requires a beefy GPU to run smoothly. You can run them in low resolution mode by editing the `run.bat` file on Windows like this:

0 commit comments

Comments
 (0)