Skip to content

Commit

Permalink
updated readme + docs
Browse files Browse the repository at this point in the history
  • Loading branch information
vsanthanam committed Jun 15, 2018
1 parent 551f097 commit 15203a5
Show file tree
Hide file tree
Showing 6 changed files with 44 additions and 69 deletions.
Original file line number Diff line number Diff line change
Expand Up @@ -46,36 +46,27 @@

<h1 id='nexum' class='heading'>Nexum</h1>

<p><img src="https://img.shields.io/badge/language-Objective--C-blue.svg" alt="language">
<img src="https://img.shields.io/github/license/vsanthanam/Nexum.svg" alt="license">
<img src="https://img.shields.io/github/release/vsanthanam/Nexum/all.svg" alt="GitHub release">
<a href="https://code.vsanthanam.com/Nexum/Documentation/"><img src="https://code.vsanthanam.com/Nexum/Documentation/badge.svg" alt="documentation"></a></p>

<p>Updated Reachability for iOS Apps in Objective-C, based on Apple&rsquo;s <a href="https://developer.apple.com/library/content/samplecode/Reachability/Introduction/Intro.html">Reachability</a>, along with some other network utilities</p>
<h2 id='about' class='heading'>About</h2>
<p><a href="https://developer.apple.com/library/content/documentation/Cocoa/Conceptual/ProgrammingWithObjectiveC/Introduction/Introduction.html"><img src="https://img.shields.io/badge/language-Objective--C-blue.svg" alt="language"></a>
<a href="https://en.wikipedia.org/wiki/MIT_License"><img src="https://img.shields.io/github/license/vsanthanam/nexum.svg" alt="license"></a>
<a href="https://github.com/vsanthanam/Nexum/releases"><img src="https://img.shields.io/github/release/vsanthanam/nexum/all.svg" alt="GitHub (pre-)release"></a>
<a href="https://code.vsanthanam.com/Nexum/Documentation/"><img src="https://code.vsanthanam.com/Nexum/Documentation/badge.svg" alt="documentation"></a>
<a href="https://cocoapods.org/pods/VSAlert"><img src="https://img.shields.io/cocoapods/v/Nexum.svg" alt="CocoaPods"></a>
<img src="https://img.shields.io/cocoapods/p/Nexum.svg" alt="CocoaPods"></p>

<p>Apple appears to have stopped updating their Reachability code. It isn&rsquo;t marked up with nullability for use with Swift projects, it doesn&rsquo;t use ARC, and is generally inflexible. Nexum is a drop-in replacement for Apple&rsquo;s reachability that is still extremely similar and very simple, but designed for easy, drop-in use and more design flexibility. Not everyone wants to use NSNotification all the time :P</p>
<h2 id='requirements' class='heading'>Requirements</h2>

<p>Nexum is compiled with the iOS 11.2 SDK, but support iOS 9.x+</p>
<h2 id='set-up' class='heading'>Set Up</h2>

<p>Take a look at the <a href="https://code.vsanthanam.com/Nexum/Documentation/project-setup.html">Project Setup guide</a> for detailed step by step instruction on setting up your project and building the documentation locally.</p>
<h2 id='usage' class='heading'>Usage</h2>

<p>Basic usage is pretty simple:</p>
<h2 id='setup' class='heading'>Setup</h2>

<ol>
<li>Create and retain a reference to an instance of an <code><a href="Classes/NXNetwork.html">NXNetwork</a></code> object, or use the shared instance for basic projects.</li>
<li>Observe changes in reachability using <code><a href="Protocols/NXNetworkDelegate.html">NXNetworkDelegate</a></code>, <code>NXNetworkReachabilityStatusChangedNotification</code>, or a block.</li>
</ol>
<p>For a quick start guide, see the <a href="https://nexum.vsanthanam.com">project website</a>.
The website is hosted on <a href="https://pages.github.com">GitHub Pages</a>, and is built using <a href="https://jekyllrb.com">Jekyll</a> and <a href="https://github.com/vsanthanam/jekyll-docs-theme">jekyll-docs-theme</a>.</p>
<h2 id='documentation' class='heading'>Documentation</h2>

<p>See the <a href="https://code.vsanthanam.com/Nexum/Documentation/designing-for-reachability.html">Designing for Reachability</a> for a detailed primer on potential different implentations, and see <a href="https://code.vsanthanam.com/Nexum/Documentation/example---basic-reachability.html">Example - Basic Reachability</a> for a quick start.</p>
<h2 id='docs' class='heading'>Docs</h2>
<p>Full documentation is available on the <a href="https://code.vsanthanam.com/Nexum/Documentation/index.html">project website</a>. Documentation is generated with <a href="https://github.com/realm/jazzy">JazzyDoc</a>, and styled using <a href="https://github.com/HarshilShah/Jony">Jony</a>. The hosted documentation is applicable for the latest version found under &lsquo;releases&rsquo;.</p>
<h2 id='contribution-guidelines' class='heading'>Contribution Guidelines</h2>

<p>The full documentaion is available <a href="https://code.vsanthanam.com/Nexum/Documentation/">here</a>, hosted on GitHub Pages, but is also included as an xcode docset.</p>
<p>See the <a href="https://code.vsanthanam.com/Nexum/CONTRIBUTING.html">contribution guidelines</a> before contributing to the project.</p>
<h2 id='community-guidelines' class='heading'>Community Guidelines</h2>

<p>Documentation with made with <a href="https://github.com/realm/jazzy">Jazzy</a> by <a href="https://realm.io">Realm</a>, using the <a href="https://github.com/HarshilShah/Jony">Jony Theme</a> by <a href="https://github.com/HarshilShah/">Harshil Shah</a></p>
<p>See the <a href="https://code.vsanthanam.com/Nexum/CODE_OF_CONDUCT.html">code of conduct</a> for detailed participation rules. Please report all violations to <a href="mailto:talkto@vsanthanam.com">talkto@vsanthanam.com</a></p>

</section>
</section>
Expand Down
Binary file modified Documentation/docsets/Nexum.tgz
Binary file not shown.
39 changes: 15 additions & 24 deletions Documentation/index.html
Original file line number Diff line number Diff line change
Expand Up @@ -46,36 +46,27 @@

<h1 id='nexum' class='heading'>Nexum</h1>

<p><img src="https://img.shields.io/badge/language-Objective--C-blue.svg" alt="language">
<img src="https://img.shields.io/github/license/vsanthanam/Nexum.svg" alt="license">
<img src="https://img.shields.io/github/release/vsanthanam/Nexum/all.svg" alt="GitHub release">
<a href="https://code.vsanthanam.com/Nexum/Documentation/"><img src="https://code.vsanthanam.com/Nexum/Documentation/badge.svg" alt="documentation"></a></p>

<p>Updated Reachability for iOS Apps in Objective-C, based on Apple&rsquo;s <a href="https://developer.apple.com/library/content/samplecode/Reachability/Introduction/Intro.html">Reachability</a>, along with some other network utilities</p>
<h2 id='about' class='heading'>About</h2>
<p><a href="https://developer.apple.com/library/content/documentation/Cocoa/Conceptual/ProgrammingWithObjectiveC/Introduction/Introduction.html"><img src="https://img.shields.io/badge/language-Objective--C-blue.svg" alt="language"></a>
<a href="https://en.wikipedia.org/wiki/MIT_License"><img src="https://img.shields.io/github/license/vsanthanam/nexum.svg" alt="license"></a>
<a href="https://github.com/vsanthanam/Nexum/releases"><img src="https://img.shields.io/github/release/vsanthanam/nexum/all.svg" alt="GitHub (pre-)release"></a>
<a href="https://code.vsanthanam.com/Nexum/Documentation/"><img src="https://code.vsanthanam.com/Nexum/Documentation/badge.svg" alt="documentation"></a>
<a href="https://cocoapods.org/pods/VSAlert"><img src="https://img.shields.io/cocoapods/v/Nexum.svg" alt="CocoaPods"></a>
<img src="https://img.shields.io/cocoapods/p/Nexum.svg" alt="CocoaPods"></p>

<p>Apple appears to have stopped updating their Reachability code. It isn&rsquo;t marked up with nullability for use with Swift projects, it doesn&rsquo;t use ARC, and is generally inflexible. Nexum is a drop-in replacement for Apple&rsquo;s reachability that is still extremely similar and very simple, but designed for easy, drop-in use and more design flexibility. Not everyone wants to use NSNotification all the time :P</p>
<h2 id='requirements' class='heading'>Requirements</h2>

<p>Nexum is compiled with the iOS 11.2 SDK, but support iOS 9.x+</p>
<h2 id='set-up' class='heading'>Set Up</h2>

<p>Take a look at the <a href="https://code.vsanthanam.com/Nexum/Documentation/project-setup.html">Project Setup guide</a> for detailed step by step instruction on setting up your project and building the documentation locally.</p>
<h2 id='usage' class='heading'>Usage</h2>

<p>Basic usage is pretty simple:</p>
<h2 id='setup' class='heading'>Setup</h2>

<ol>
<li>Create and retain a reference to an instance of an <code><a href="Classes/NXNetwork.html">NXNetwork</a></code> object, or use the shared instance for basic projects.</li>
<li>Observe changes in reachability using <code><a href="Protocols/NXNetworkDelegate.html">NXNetworkDelegate</a></code>, <code>NXNetworkReachabilityStatusChangedNotification</code>, or a block.</li>
</ol>
<p>For a quick start guide, see the <a href="https://nexum.vsanthanam.com">project website</a>.
The website is hosted on <a href="https://pages.github.com">GitHub Pages</a>, and is built using <a href="https://jekyllrb.com">Jekyll</a> and <a href="https://github.com/vsanthanam/jekyll-docs-theme">jekyll-docs-theme</a>.</p>
<h2 id='documentation' class='heading'>Documentation</h2>

<p>See the <a href="https://code.vsanthanam.com/Nexum/Documentation/designing-for-reachability.html">Designing for Reachability</a> for a detailed primer on potential different implentations, and see <a href="https://code.vsanthanam.com/Nexum/Documentation/example---basic-reachability.html">Example - Basic Reachability</a> for a quick start.</p>
<h2 id='docs' class='heading'>Docs</h2>
<p>Full documentation is available on the <a href="https://code.vsanthanam.com/Nexum/Documentation/index.html">project website</a>. Documentation is generated with <a href="https://github.com/realm/jazzy">JazzyDoc</a>, and styled using <a href="https://github.com/HarshilShah/Jony">Jony</a>. The hosted documentation is applicable for the latest version found under &lsquo;releases&rsquo;.</p>
<h2 id='contribution-guidelines' class='heading'>Contribution Guidelines</h2>

<p>The full documentaion is available <a href="https://code.vsanthanam.com/Nexum/Documentation/">here</a>, hosted on GitHub Pages, but is also included as an xcode docset.</p>
<p>See the <a href="https://code.vsanthanam.com/Nexum/CONTRIBUTING.html">contribution guidelines</a> before contributing to the project.</p>
<h2 id='community-guidelines' class='heading'>Community Guidelines</h2>

<p>Documentation with made with <a href="https://github.com/realm/jazzy">Jazzy</a> by <a href="https://realm.io">Realm</a>, using the <a href="https://github.com/HarshilShah/Jony">Jony Theme</a> by <a href="https://github.com/HarshilShah/">Harshil Shah</a></p>
<p>See the <a href="https://code.vsanthanam.com/Nexum/CODE_OF_CONDUCT.html">code of conduct</a> for detailed participation rules. Please report all violations to <a href="mailto:talkto@vsanthanam.com">talkto@vsanthanam.com</a></p>

</section>
</section>
Expand Down
Binary file not shown.
35 changes: 14 additions & 21 deletions README.md
Original file line number Diff line number Diff line change
@@ -1,34 +1,27 @@
# Nexum

![language](https://img.shields.io/badge/language-Objective--C-blue.svg)
![license](https://img.shields.io/github/license/vsanthanam/Nexum.svg)
![GitHub release](https://img.shields.io/github/release/vsanthanam/Nexum/all.svg)
[![language](https://img.shields.io/badge/language-Objective--C-blue.svg)](https://developer.apple.com/library/content/documentation/Cocoa/Conceptual/ProgrammingWithObjectiveC/Introduction/Introduction.html)
[![license](https://img.shields.io/github/license/vsanthanam/nexum.svg)](https://en.wikipedia.org/wiki/MIT_License)
[![GitHub (pre-)release](https://img.shields.io/github/release/vsanthanam/nexum/all.svg)](https://github.com/vsanthanam/Nexum/releases)
[![documentation](https://code.vsanthanam.com/Nexum/Documentation/badge.svg)](https://code.vsanthanam.com/Nexum/Documentation/)

Updated Reachability for iOS Apps in Objective-C, based on Apple's [Reachability](https://developer.apple.com/library/content/samplecode/Reachability/Introduction/Intro.html), along with some other network utilities

## About
[![CocoaPods](https://img.shields.io/cocoapods/v/Nexum.svg)](https://cocoapods.org/pods/VSAlert)
![CocoaPods](https://img.shields.io/cocoapods/p/Nexum.svg)

Apple appears to have stopped updating their Reachability code. It isn't marked up with nullability for use with Swift projects, it doesn't use ARC, and is generally inflexible. Nexum is a drop-in replacement for Apple's reachability that is still extremely similar and very simple, but designed for easy, drop-in use and more design flexibility. Not everyone wants to use NSNotification all the time :P

## Requirements

Nexum is compiled with the iOS 11.2 SDK, but support iOS 9.x+

## Set Up
## Setup

Take a look at the [Project Setup guide](https://code.vsanthanam.com/Nexum/Documentation/project-setup.html) for detailed step by step instruction on setting up your project and building the documentation locally.
For a quick start guide, see the [project website](https://nexum.vsanthanam.com).
The website is hosted on [GitHub Pages](https://pages.github.com), and is built using [Jekyll](https://jekyllrb.com) and [jekyll-docs-theme](https://github.com/vsanthanam/jekyll-docs-theme).

## Usage
## Documentation

Basic usage is pretty simple:
1. Create and retain a reference to an instance of an `NXNetwork` object, or use the shared instance for basic projects.
2. Observe changes in reachability using `NXNetworkDelegate`, `NXNetworkReachabilityStatusChangedNotification`, or a block.
Full documentation is available on the [project website](https://code.vsanthanam.com/Nexum/Documentation/index.html). Documentation is generated with [JazzyDoc](https://github.com/realm/jazzy), and styled using [Jony](https://github.com/HarshilShah/Jony). The hosted documentation is applicable for the latest version found under 'releases'.

See the [Designing for Reachability](https://code.vsanthanam.com/Nexum/Documentation/designing-for-reachability.html) for a detailed primer on potential different implentations, and see [Example - Basic Reachability](https://code.vsanthanam.com/Nexum/Documentation/example---basic-reachability.html) for a quick start.
## Contribution Guidelines

## Docs
See the [contribution guidelines](https://code.vsanthanam.com/Nexum/CONTRIBUTING.html) before contributing to the project.

The full documentaion is available [here](https://code.vsanthanam.com/Nexum/Documentation/), hosted on GitHub Pages, but is also included as an xcode docset.
## Community Guidelines

Documentation with made with [Jazzy](https://github.com/realm/jazzy) by [Realm](https://realm.io), using the [Jony Theme](https://github.com/HarshilShah/Jony) by [Harshil Shah](https://github.com/HarshilShah/)
See the [code of conduct](https://code.vsanthanam.com/Nexum/CODE_OF_CONDUCT.html) for detailed participation rules. Please report all violations to [talkto@vsanthanam.com](mailto:talkto@vsanthanam.com)
Binary file modified Release/Nexum.framework/Versions/A/Nexum
Binary file not shown.

0 comments on commit 15203a5

Please sign in to comment.