Skip to content

Commit

Permalink
Start Docs initially with CRISP-DM
Browse files Browse the repository at this point in the history
  • Loading branch information
ProsperousHeart committed Apr 13, 2019
1 parent 6d30f5f commit bf54ce9
Show file tree
Hide file tree
Showing 19 changed files with 274 additions and 5 deletions.
Empty file added Docs/.gitignore
Empty file.
1 change: 1 addition & 0 deletions Docs/CRISP-DM/.gitignore
Original file line number Diff line number Diff line change
@@ -0,0 +1 @@
.idea/
9 changes: 9 additions & 0 deletions Docs/CRISP-DM/README.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,9 @@
<a href='https://www.learntocodeonline.com/'>![Learn To Code Online By Clicking Here](../../Images/learn-to-code-online.png?raw=true "Learn To Code Online")</a>

# What Is CRSIP-DM?

A brief explanation was provided [here](../README.MD#Table-Of-Contents)

# How To Print This Documentation

If you wish to have this documentation printed to PDF, you can use [GRIP](https://gist.github.com/justincbagley/ec0a6334cc86e854715e459349ab1446) to convert the markdown files for you. It looks like [Atom has a similar feature](https://superuser.com/a/722374) as well.
3 changes: 3 additions & 0 deletions Docs/CRISP-DM/code/README.MD
Original file line number Diff line number Diff line change
@@ -0,0 +1,3 @@
<a href='https://www.learntocodeonline.com/'>![Learn To Code Online By Clicking Here](../../../Images/learn-to-code-online.png?raw=true "Learn To Code Online")</a>

TBD
3 changes: 3 additions & 0 deletions Docs/CRISP-DM/datasets/README.MD
Original file line number Diff line number Diff line change
@@ -0,0 +1,3 @@
<a href='https://www.learntocodeonline.com/'>![Learn To Code Online By Clicking Here](../../../Images/learn-to-code-online.png?raw=true "Learn To Code Online")</a>

TBD
Original file line number Diff line number Diff line change
@@ -0,0 +1,38 @@
<a href='https://www.learntocodeonline.com/'>![Learn To Code Online By Clicking Here](../../../../Images/learn-to-code-online.png?raw=true "Learn To Code Online")</a>

# PROJECTNAME Business Objectives
- [Background](#background)
- [Business Climate](#business-climate)
- [Business Problem Statement](#business-problem-statement)
- [Business Objectives](#business-objectives)
- [Business Success Criteria](#business-success-criteria)

## Background

TBD

## Business Climate

TBD

## Business Problem Statement

TBD

## Business Objectives

TBD

## Business Success Criteria

TBD

### Functionality Criteria

The solution should:

- TBD

Opportunities for business value include:

1. TBD
63 changes: 63 additions & 0 deletions Docs/CRISP-DM/docs/1_business_understanding/2_Situation.MD
Original file line number Diff line number Diff line change
@@ -0,0 +1,63 @@
<a href='https://www.learntocodeonline.com/'>![Learn To Code Online By Clicking Here](../../../../Images/learn-to-code-online.png?raw=true "Learn To Code Online")</a>

# Situation

- Inventory Of Resources
- Requirements, Assumptions, & Constraints
- Risks & Contingencies
- Terminology
- Costs & Benefits

## Inventory Of Resources

### People Resources

#### Executive Leadership

| Name | Email | Phone |
| --- | :---: | :---: |
| NA | NA | NA |

#### Current Project Team

| Name | Email | Phone | Project Role | Availability<br>hr/week | Location | Notes |
| --- | :---: | :---: | :---: | :---: | :---: | --- |
| Kassandra Keeton | [LinkedIn](https://linkedin.com/in/kkeeton/) | Python Mentor, Data Science Ambassador | Lead Developer | Flexible | TX, USA | TBD |

#### Programming Resources

| Name | Email | Phone | Project Role | Availability<br>hr/week | Location | Notes |
| --- | :---: | :---: | :---: | :---: | :---: | --- |
| Kassandra Keeton | [LinkedIn](https://linkedin.com/in/kkeeton/) | Python Mentor, Data Science Ambassador | Lead Developer | Flexible | TX, USA | TBD |

#### Prior Project Team

| Name | CEC | Cisco Role | Project Role | Availability<br>hr/week | Location | Notes |
| --- | :---: | :---: | :---: | :---: | :---: | --- |
| TBD | | | | | | |

### Data Resources

| Name | Email | Phone | Project Role | Availability<br>hr/week | Location | Notes |
| --- | :---: | :---: | :---: | :---: | :---: | --- |
| Kassandra Keeton | [LinkedIn](https://linkedin.com/in/kkeeton/) | Python Mentor, Data Science Ambassador | Lead Developer | Flexible | TX, USA | TBD |

More information can be found in the [Data Understanding](../2_data_understanding/README.MD) section of this CRISP-DM documentation and the [datasets](../../datasets) subfolder of the git repo.

TBD

## Requirements, Assumptions, & Constraints

TBD

## Risks & Contingencies

TBD

## Terminology

TBD

## Costs & Benefits

TBD
Original file line number Diff line number Diff line change
@@ -0,0 +1,2 @@
<a href='https://www.learntocodeonline.com/'>![Learn To Code Online By Clicking Here](../../../../Images/learn-to-code-online.png?raw=true "Learn To Code Online")</a>

2 changes: 2 additions & 0 deletions Docs/CRISP-DM/docs/1_business_understanding/4_Project_Plan.MD
Original file line number Diff line number Diff line change
@@ -0,0 +1,2 @@
<a href='https://www.learntocodeonline.com/'>![Learn To Code Online By Clicking Here](../../../../Images/learn-to-code-online.png?raw=true "Learn To Code Online")</a>

33 changes: 33 additions & 0 deletions Docs/CRISP-DM/docs/1_business_understanding/README.MD
Original file line number Diff line number Diff line change
@@ -0,0 +1,33 @@
<a href='https://www.learntocodeonline.com/'>![Learn To Code Online By Clicking Here](../../../../Images/learn-to-code-online.png?raw=true "Learn To Code Online")</a>

# Cross-Skilling Business Understanding

1. [Business Objectives](1_Business_Objectives.MD)

The Business Objectives specifies the following:

- the background
- business climate
- business problem statement
- business objectives
- business success criteria

2. [Situation](2_Situation.MD)

The situation section identifies:

- the inventory of resources
- requirements
- assumptions
- constraints
- risks and contingencies
- terminology
- costs & benefits

3. [Data Mining Goals](3_Data_Mining_Goals.MD)

The Data Mining Goals specifies Data Mining objectives & success criteria.

4. [Project Plan](4_Project_Plan.MD)

The Project Plan specifies the Project Plan, Assessment of Tools, and Techniques.
2 changes: 2 additions & 0 deletions Docs/CRISP-DM/docs/2_data_understanding/README.MD
Original file line number Diff line number Diff line change
@@ -0,0 +1,2 @@
<a href='https://www.learntocodeonline.com/'>![Learn To Code Online By Clicking Here](../../../../Images/learn-to-code-online.png?raw=true "Learn To Code Online")</a>

2 changes: 2 additions & 0 deletions Docs/CRISP-DM/docs/3_data_preparation/README.MD
Original file line number Diff line number Diff line change
@@ -0,0 +1,2 @@
<a href='https://www.learntocodeonline.com/'>![Learn To Code Online By Clicking Here](../../../../Images/learn-to-code-online.png?raw=true "Learn To Code Online")</a>

2 changes: 2 additions & 0 deletions Docs/CRISP-DM/docs/4_modeling/README.MD
Original file line number Diff line number Diff line change
@@ -0,0 +1,2 @@
<a href='https://www.learntocodeonline.com/'>![Learn To Code Online By Clicking Here](../../../../Images/learn-to-code-online.png?raw=true "Learn To Code Online")</a>

2 changes: 2 additions & 0 deletions Docs/CRISP-DM/docs/5_evaluation/README.MD
Original file line number Diff line number Diff line change
@@ -0,0 +1,2 @@
<a href='https://www.learntocodeonline.com/'>![Learn To Code Online By Clicking Here](../../../../Images/learn-to-code-online.png?raw=true "Learn To Code Online")</a>

2 changes: 2 additions & 0 deletions Docs/CRISP-DM/docs/6_deployment/README.MD
Original file line number Diff line number Diff line change
@@ -0,0 +1,2 @@
<a href='https://www.learntocodeonline.com/'>![Learn To Code Online By Clicking Here](../../../../Images/learn-to-code-online.png?raw=true "Learn To Code Online")</a>

41 changes: 41 additions & 0 deletions Docs/CRISP-DM/docs/CODEOWNERS
Validating CODEOWNERS rules …
Original file line number Diff line number Diff line change
@@ -0,0 +1,41 @@
# Each line is a file pattern followed by one or more owners.

# These owners will be the default owners for everything in
# the repo. Unless a later match takes precedence,
# @global-owner1 and @global-owner2 will be requested for
# review when someone opens a pull request.
* @prosperousheart

# ------------------------------------------------------------------------------
# The rest of this is for information on how to update in the future:
# https://help.github.com/en/enterprise/2.14/user/articles/about-code-owners
# ------------------------------------------------------------------------------

# Order is important; the last matching pattern takes the most
# precedence. When someone opens a pull request that only
# modifies JS files, only @js-owner and not the global
# owner(s) will be requested for a review.
# *.js @js-owner

# You can also use email addresses if you prefer. They'll be
# used to look up users just like we do for commit author
# emails.
# *.go [email protected]

# In this example, @doctocat owns any files in the build/logs
# directory at the root of the repository and any of its
# subdirectories.
# /build/logs/ @doctocat

# The `docs/*` pattern will match files like
# `docs/getting-started.md` but not further nested files like
# `docs/build-app/troubleshooting.md`.
# docs/* [email protected]

# In this example, @octocat owns any file in an apps directory
# anywhere in your repository.
# apps/ @octocat

# In this example, @doctocat owns any file in the `/docs`
# directory in the root of your repository.
# /docs/ @doctocat
31 changes: 31 additions & 0 deletions Docs/CRISP-DM/docs/README.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,31 @@
<a href='https://www.learntocodeonline.com/'>![Learn To Code Online By Clicking Here](../../../../Images/learn-to-code-online.png?raw=true "Learn To Code Online")</a>

# CRISP-DM For PROJECTNAME

This docs section will provide information on the planning, resources, needs, timeline, and more regarding the needs of this project.

# Sections

1. [Business Understanding](1_business_understanding/README.MD)

Business understanding documents the project objectives & requirements from a business perspective, the data mining definition, and a preliminary plan.

2. [Data Understanding](2_data_understanding/README.MD)

Data Understanding documents the datasets acquired, their locations, methods used to acquire them, and any problems encountered - including how they were resolved.

3. [Data Preparation](3_data_preparation/README.MD)

Data Preparation documents the process of cleaning the data, including what decisions and actions were taken to address the data quality problems raised in the Data Understanding phase.

4. [Modeling](4_modeling/README.MD)

Modeling documents the results of selecting modeling techniques, generating test designs, building models, and assessing models.

5. [Evaluation](5_evaluation/README.MD)

Evaluation documents the results of evaluating results, reviewing process, and determining next steps.

6. [Deployment](6_deployment/README.MD)

Deployment specifies the deployment of the data mining results.
31 changes: 31 additions & 0 deletions Docs/README.MD
Original file line number Diff line number Diff line change
@@ -0,0 +1,31 @@
<a href='https://www.learntocodeonline.com/'>![Learn To Code Online By Clicking Here](../Images/learn-to-code-online.png?raw=true "Learn To Code Online")</a>

# Explanation Of Docs

Since we're in the [cheatsheets](../) portion of [my GitHub](https://github.com/ProsperousHeart), I decided to create a section for documentation templates.

The more I learn on my journey as a computer scientist / data scientist, the more I find it beneficial to simply just have an empty template for my different projects & documentation.

Why reinvent the wheel, right?

# Table Of Contents

1. [CRISP-DM](CRISP-DM): "Cross-Industry Standard Process for Data Mining"

According to [the IBM Knowledge Center](https://www.ibm.com/support/knowledgecenter/en/SS3RA7_15.0.0/com.ibm.spss.crispdm.help/crisp_overview.htm), this "is an industry-proven way to guide your data mining efforts" - and quite frankly? It makes the organizer in me VERY happy!

<a href="https://www.ibm.com/support/knowledgecenter/en/SS3RA7_15.0.0/com.ibm.spss.crispdm.help/crisp_overview.htm"><img align="middle" src="https://www.ibm.com/support/knowledgecenter/SS3RA7_15.0.0/com.ibm.spss.crispdm.help/images/crisp_process.gif"></img></a>

As a **methodolody** it includes:
- descriptions of the typical phases of a project
- tasks involved with each phase
- an explanation of the relationships between tasks

As a **process model**:
- provides an overview of the data mining life cycle

By following this process, you are able to create a data mining model that fits your particulat needs.

I have taken what I have learned & crafted my own blank template inside of this section. Including but not limited to:
- [folder structure](CRISP-DM/README.MD) for future code projects
- [fluid documentation](CRISP-DM/docs)
12 changes: 7 additions & 5 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -27,18 +27,20 @@ Have something to share? Please create an issue first and then follow the normal

At the moment I am still working on this. But as it grows, the tree will begin to form. And you will be able to access whatever your heart desires & is available here.

1. [Tools](https://github.com/ProsperousHeart/cheatsheets/tree/master/Tools)
1. [Docs](Docs/README.MD)
- [CRISP-DM](Docs/CRISP-DM/README.md)
2. [Processes](https://github.com/ProsperousHeart/cheatsheets/tree/master/Processes)
- [Working With Git](https://github.com/ProsperousHeart/cheatsheets/blob/master/Processes/WorkingGit.md)
3. [Tools](https://github.com/ProsperousHeart/cheatsheets/tree/master/Tools)
- [Anaconda](https://github.com/ProsperousHeart/cheatsheets/blob/master/Tools/Anaconda.md)
- [git](https://github.com/ProsperousHeart/cheatsheets/blob/master/Tools/git.md)
- [Jupyter notebooks](https://github.com/ProsperousHeart/cheatsheets/blob/master/Tools/JupyterNotebooks.md)
- [Misc](https://github.com/ProsperousHeart/cheatsheets/blob/master/Tools/Misc.md)
- [pip](https://github.com/ProsperousHeart/cheatsheets/blob/master/Tools/pip.md)
- [Testing](https://github.com/ProsperousHeart/cheatsheets/blob/master/Tools/Testing.md)
- [Virtual Environments](https://github.com/ProsperousHeart/cheatsheets/blob/master/Tools/VirtualEnvironments.md)
2. [Processes](https://github.com/ProsperousHeart/cheatsheets/tree/master/Processes)
- [Working With Git](https://github.com/ProsperousHeart/cheatsheets/blob/master/Processes/WorkingGit.md)
3. [README](https://github.com/ProsperousHeart/cheatsheets/blob/master/README.md)
4. [Thank You](https://github.com/ProsperousHeart/cheatsheets/blob/master/Thank_You.md)
4. [README](https://github.com/ProsperousHeart/cheatsheets/blob/master/README.md)
5. [Thank You](https://github.com/ProsperousHeart/cheatsheets/blob/master/Thank_You.md)

Happy Coding!
- Kassandra from [Learn To Code Online](http://www.learntocodeonline.com)

0 comments on commit bf54ce9

Please sign in to comment.