Re: documentation suggestions

2017-10-05 Thread Dmitriy Setrakyan
Denis,

Thanks for your comments.

The pages I suggested have to do with the "getting started" or "how to's"
for Ignite. Burying it inside of other docs will not make sense. That is
why I suggested adding them under "Basic Concepts" section, i.e. keep them
very visible.

D.

On Thu, Oct 5, 2017 at 12:07 AM, Denis Magda  wrote:

> Please see inline
>
> > On Oct 4, 2017, at 5:17 AM, Dmitriy Setrakyan 
> wrote:
> >
> > I would like to propose some changes to the Ignite documentation:
> >
> >   - Under Basic Concepts add the following pages:
> >  - "How to load data”
>
> This should go to “Data Loading” or Streaming sections that appear at the
> top of the doc. We have more room there once new SQL doc is released.
>
> >  - "SQL vs Scan"
> >  - "SQL vs Key-Value”
>
> Yes, it’s needed. The production readiness might be a good alternative to
> host the pages.
>
> >  - more?
> >   - For persistence section, add the following pages:
> >  - Write-Ahead-Log (WAL)
> > - BTW, I could not find WAL modes anywhere in documentation
> >  - Main Store (or Checkpointing)
>
> Presently, everything is in a good fit on a single persistence page. The
> navigation menu on the readme.io  is lengthy and might
> scary the one who sets off Ignite journey. It takes several seconds to
> scroll it down to brace for the volume you should absorb. Let’s release the
> new SQL doc and see how much space is free there before extracting pages
> out of the paragraphs. Also we can try out subpages.
>
> WAL modes documentation: https://issues.apache.org/jira/browse/IGNITE-6558
> 
>
> —
> Denis
>
> >  - Configuration
> >
> > Thoughts?
> >
> > D.
>
>


Re: documentation suggestions

2017-10-04 Thread Prachi Garg
WAL modes is documented -
https://apacheignite.readme.io/v2.2/docs/ignite-persistence-23#section-wal-modes

On Wed, Oct 4, 2017 at 2:07 PM, Denis Magda  wrote:

> Please see inline
>
> > On Oct 4, 2017, at 5:17 AM, Dmitriy Setrakyan 
> wrote:
> >
> > I would like to propose some changes to the Ignite documentation:
> >
> >   - Under Basic Concepts add the following pages:
> >  - "How to load data”
>
> This should go to “Data Loading” or Streaming sections that appear at the
> top of the doc. We have more room there once new SQL doc is released.
>
> >  - "SQL vs Scan"
> >  - "SQL vs Key-Value”
>
> Yes, it’s needed. The production readiness might be a good alternative to
> host the pages.
>
> >  - more?
> >   - For persistence section, add the following pages:
> >  - Write-Ahead-Log (WAL)
> > - BTW, I could not find WAL modes anywhere in documentation
> >  - Main Store (or Checkpointing)
>
> Presently, everything is in a good fit on a single persistence page. The
> navigation menu on the readme.io  is lengthy and might
> scary the one who sets off Ignite journey. It takes several seconds to
> scroll it down to brace for the volume you should absorb. Let’s release the
> new SQL doc and see how much space is free there before extracting pages
> out of the paragraphs. Also we can try out subpages.
>
> WAL modes documentation: https://issues.apache.org/jira/browse/IGNITE-6558
> 
>
> —
> Denis
>
> >  - Configuration
> >
> > Thoughts?
> >
> > D.
>
>


Re: documentation suggestions

2017-10-04 Thread Denis Magda
Please see inline

> On Oct 4, 2017, at 5:17 AM, Dmitriy Setrakyan  wrote:
> 
> I would like to propose some changes to the Ignite documentation:
> 
>   - Under Basic Concepts add the following pages:
>  - "How to load data”

This should go to “Data Loading” or Streaming sections that appear at the top 
of the doc. We have more room there once new SQL doc is released.

>  - "SQL vs Scan"
>  - "SQL vs Key-Value”

Yes, it’s needed. The production readiness might be a good alternative to host 
the pages.

>  - more?
>   - For persistence section, add the following pages:
>  - Write-Ahead-Log (WAL)
> - BTW, I could not find WAL modes anywhere in documentation
>  - Main Store (or Checkpointing)

Presently, everything is in a good fit on a single persistence page. The 
navigation menu on the readme.io  is lengthy and might scary 
the one who sets off Ignite journey. It takes several seconds to scroll it down 
to brace for the volume you should absorb. Let’s release the new SQL doc and 
see how much space is free there before extracting pages out of the paragraphs. 
Also we can try out subpages.

WAL modes documentation: https://issues.apache.org/jira/browse/IGNITE-6558 


—
Denis

>  - Configuration
> 
> Thoughts?
> 
> D.



Re: documentation suggestions

2017-10-04 Thread Sergey Chugunov
Dmitriy,

There is a short description of WAL modes on the page:
https://cwiki.apache.org/confluence/display/IGNITE/Ignite+Persistent+Store+-+under+the+hood
.



On Wed, Oct 4, 2017 at 3:17 PM, Dmitriy Setrakyan 
wrote:

> I would like to propose some changes to the Ignite documentation:
>
>- Under Basic Concepts add the following pages:
>   - "How to load data"
>   - "SQL vs Scan"
>   - "SQL vs Key-Value"
>   - more?
>- For persistence section, add the following pages:
>   - Write-Ahead-Log (WAL)
>  - BTW, I could not find WAL modes anywhere in documentation
>   - Main Store (or Checkpointing)
>   - Configuration
>
> Thoughts?
>
> D.
>


documentation suggestions

2017-10-04 Thread Dmitriy Setrakyan
I would like to propose some changes to the Ignite documentation:

   - Under Basic Concepts add the following pages:
  - "How to load data"
  - "SQL vs Scan"
  - "SQL vs Key-Value"
  - more?
   - For persistence section, add the following pages:
  - Write-Ahead-Log (WAL)
 - BTW, I could not find WAL modes anywhere in documentation
  - Main Store (or Checkpointing)
  - Configuration

Thoughts?

D.