After an evaluation, GNOME has moved from Bugzilla to GitLab. Learn more about GitLab.
No new issues can be reported in GNOME Bugzilla anymore.
To report an issue in a GNOME project, go to GNOME GitLab.
Do not go to GNOME Gitlab for: Bluefish, Doxygen, GnuCash, GStreamer, java-gnome, LDTP, NetworkManager, Tomboy.
Bug 702894 - Getting Started does not clearly specify what kinds of files are covered
Getting Started does not clearly specify what kinds of files are covered
Status: RESOLVED FIXED
Product: gnome-documents
Classification: Core
Component: documentation
3.8.x
Other All
: Normal normal
: ---
Assigned To: Maintainers of Gnome user documentation
Maintainers of Gnome user documentation
Depends on:
Blocks:
 
 
Reported: 2013-06-23 11:47 UTC by Kat
Modified: 2014-03-12 11:52 UTC
See Also:
GNOME target: ---
GNOME version: ---


Attachments
a slightly useless screenshot showing that there really are no documents in Documents (113.83 KB, image/png)
2013-06-23 11:47 UTC, Kat
  Details
getting-started: point to help for more. (39.37 KB, patch)
2014-02-05 13:22 UTC, Jakub Steiner
none Details | Review
getting-started: point to help for more info. (37.46 KB, patch)
2014-02-05 13:59 UTC, Jakub Steiner
committed Details | Review
Screenshot of the new page (21.55 KB, image/png)
2014-03-03 13:09 UTC, Debarshi Ray
  Details

Description Kat 2013-06-23 11:47:49 UTC
Created attachment 247558 [details]
a slightly useless screenshot showing that there really are no documents in Documents

On running documents for the first time, my documents, which are in Home/Documents/ are not being shown in Documents.

The user help specifies that all documents should be shown automatically.
Comment 1 Debarshi Ray 2013-08-13 13:22:17 UTC
After talking to Kat in #gnome-hackers on IRC, this is about:

1. She has lots of text/plain files which are not shown by Documents. That is actually bug 671051
2. She has files that she considers to be documents outside of ~/Documents and ~/Download, which are intentionally ignored by Documents.
3. The "Getting started with Documents" does not clearly specify what kinds of files are shown by the application.
Comment 2 Kat 2014-02-05 12:21:59 UTC
Hi Debarshi, the getting started document seems to be out of date now (some of the instructions are incorrect or don't work). Do you think it may be a better idea to use the user help as the getting started document instead? It should be possible to generate a PDF from it without much difficulty.

I'm relatively competent at working with SVGs, but I do find that it's still quite difficult to get the layout spot-on when updating text, which is why I'm loath to update the getting started files.
Comment 3 Debarshi Ray 2014-02-05 12:46:30 UTC
(In reply to comment #2)
> Hi Debarshi, the getting started document seems to be out of date now (some of
> the instructions are incorrect or don't work).

What is out of date? What is incorrect? What does not work?
Comment 4 Jakub Steiner 2014-02-05 12:47:37 UTC
(In reply to comment #2)
> Hi Debarshi, the getting started document seems to be out of date now (some of
> the instructions are incorrect or don't work). Do you think it may be a better
> idea to use the user help as the getting started document instead? It should be
> possible to generate a PDF from it without much difficulty.

Anything outside of https://bugzilla.gnome.org/show_bug.cgi?id=723028 ? I think those deserve specific bugs filed.

Focusing on the title of this bug report:

A user with no linked online account and previous history of working with local files will is not an irrelevant case. I still think narrow scope indexing ~/Documents is a good default, but we should perhaps make the path of adding new locations to look for documents easier. I kind of feel this is outside of the scope of Getting Started though. What we should perhaps do is to point to the help on the last page of it.
Comment 5 Jakub Steiner 2014-02-05 13:22:18 UTC
Created attachment 268172 [details] [review]
getting-started: point to help for more.
Comment 6 Jakub Steiner 2014-02-05 13:23:59 UTC
Czenglish might need some fixing.
Comment 7 Jakub Steiner 2014-02-05 13:59:15 UTC
Created attachment 268177 [details] [review]
getting-started: point to help for more info.
Comment 8 Debarshi Ray 2014-03-03 13:09:06 UTC
Created attachment 270788 [details]
Screenshot of the new page
Comment 9 Debarshi Ray 2014-03-03 13:12:07 UTC
Review of attachment 268177 [details] [review]:

Looks good. Lets get this in because we are getting deeper and deeper into the freezes.
Comment 10 Jakub Steiner 2014-03-04 11:44:38 UTC
pushed as 8a9857ce8d345e491a177b52adcd30b8179ae72c
Comment 11 Kat 2014-03-12 11:52:55 UTC
(In reply to comment #4)
> (In reply to comment #2)
> > Hi Debarshi, the getting started document seems to be out of date now (some of
> > the instructions are incorrect or don't work).
>
> Anything outside of https://bugzilla.gnome.org/show_bug.cgi?id=723028 ? I think
> those deserve specific bugs filed.

Sure, I've started filing specific bugs for those and will do the rest first chance I get :)