Skip to content
This repository has been archived by the owner on Jul 20, 2020. It is now read-only.

[#34] Updated documentation and added CONTRIBUTING.md #39

Merged
merged 1 commit into from
Aug 27, 2018
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
45 changes: 45 additions & 0 deletions docs/CONTRIBUTING.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,45 @@

# Contributing to PPExtensions

## Discussions

Our recommendation is to start a slack discussion as soon as you have an idea for contributing to PPExtensions.
This will help you, other interested contributors & the committers get to common grounds early in time.
Contact the PPExtenions community on [slack](https://join.slack.com/t/ppextensions/shared_invite/enQtNDIyODk5NzYzMzEyLTIwOGM3MWE0OGZlNjFkYTUxZTJiN2NjOWFlNmUxNDRiY2U3MzE0Nzg5NDRjZjE2M2VmZGI4NWJhOGVjYTRiMTk).

--------------------------------------------------------------------------------------------------------------------

## How can you help

### Code
Look for Issues that are open on below categories, pick an issue, start a slack discussion on slack channel, once we get to common grounds on the solution approach, open a PR with your implementation.
* Bug Fixes
* Enhancements & Improvements (Jira Details)
* Add a new extension that you see are useful to Jupyter community

### Documentation
You can also improve our documentation
* readme.md
* docs/*.md
* Any other valuable comment you'd like to add to the code that will simplify other developers' lives.

--------------------------------------------------------------------------------------------------------------------


## Contribution Process

* Get your github account.
* Fork the PPExtensions repo into your account.
* Create an issue branch using the master branch.
* Make modifications to the code.
* Ensure code coverage by added test cases.
* All commits must have the issue ID & summary. Say "[#32] Add Codacy Integration and Badge".
* Ensure all your commits are squashed.
* Make a Pull Request to develop branch.
* If there are code review related changes - ensure those commits are also squashed.
* DO NOT include changes that are not directly related to the issue you are trying to resolve.
* Once PR is approved, code will be merged to Development branch.
* Once all regression test cases have passed - changes will be merged to master branch.

--------------------------------------------------------------------------------------------------------------------

9 changes: 5 additions & 4 deletions docs/getting-started/build-ppextensions.md
Original file line number Diff line number Diff line change
@@ -1,15 +1,16 @@
## Install
```buildoutcfg
```
pip install ppextensions
```

## Try ppextensions
```
%load_ext ppextensions.ppmagics
```

Try help to see all the available options
```buildoutcfg
%%help?
```
%help
```

| Magic | Usage | Explanation |
Expand All @@ -24,4 +25,4 @@ Try help to see all the available options


For more info:
[Github Link](git@github.com:paypal/PPExtensions.git)
[Github Link](https://github.com/paypal/PPExtensions/)
10 changes: 5 additions & 5 deletions docs/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -5,10 +5,10 @@ PPExtensions is a suite of ipython and jupyter extensions built to improve user

# Features

- **PPMagics** - Set of magics to simplify access to different storage systems and tableau.
- **Github Integration** - A jupyter extension to integrate notebooks with github. This extension simplifies version controlling, sharing and resolving merge conflicts of notebooks.
- **Notebooks Scheduling** - A jupyter extension to productionalize the notebooks development environment. This extension enables scheduling notebooks with help of [airflow](https://airflow.apache.org/).
- **Config UI** - A simple UI built to change the configurations of different extensions like PPMagic, [sparkmagic](https://github.com/jupyter-incubator/sparkmagic) ..etc.
- **[PPMagics](ppmagics/csv.md)** - Set of magics to simplify access to different storage systems and tableau.
- **[Github Integration](ppextensions-github-integration/github-integration.md)** - A jupyter extension to integrate notebooks with github. This extension simplifies version controlling, sharing and resolving merge conflicts of notebooks.
- **[Notebooks Scheduling](ppextensions-scheduler/scheduler.md)** - A jupyter extension to productionalize the notebooks development environment. This extension enables scheduling notebooks with help of [airflow](https://airflow.apache.org/).
- **[Config UI](ppextensions-config-ui/config-ui.md)** - A simple UI built to change the configurations of different extensions like PPMagic, [sparkmagic](https://github.com/jupyter-incubator/sparkmagic) ..etc.


# Installation
Expand All @@ -33,6 +33,6 @@ PPExtensions is a suite of ipython and jupyter extensions built to improve user

# Questions

* [Slack](https://ppextensions.slack.com)
* [Slack](https://join.slack.com/t/ppextensions/shared_invite/enQtNDIyODk5NzYzMzEyLTIwOGM3MWE0OGZlNjFkYTUxZTJiN2NjOWFlNmUxNDRiY2U3MzE0Nzg5NDRjZjE2M2VmZGI4NWJhOGVjYTRiMTk)
* [User Forum](https://groups.google.com/d/forum/ppextensions)
* [Developer Forum](https://groups.google.com/d/forum/ppextensions)
3 changes: 3 additions & 0 deletions docs/ppextensions-config-ui/config-ui.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,3 @@
## Config UI

Coming Soon