Re: [Inkscape-docs] more prominent link to the wiki?

2015-06-19 Thread Brynn

Hi Maren,
   Out of curiosity, when you type "wik" in you browser, how does it 
know to find the Inkscape wiki, and not Wikipedia, or Wikimedia, or some 
other program's wiki, etc?
   If users are looking to the Roadmap as "set in stone" then they 
simply need to be informed properly.  For as long as I've been using 
Inkscape (8 years), the wiki has been a resource for both users and 
developers.  Most of them have no idea that it's being groomed as 'developer 
only'.  Ask Martin how many times I asked him to confirm that, Yes, the wiki 
will only be for developers.  At least 4 or 5, as I recall.  **It's a 
radical change, and afaik, I'm the only user who knows that.**
   Not only do I have a list of wiki articles that are user-related, 
that are linked from the FAQ (attached), I actually started to make a list 
of ALL wiki articles that are for users.  But I started getting tripped up 
when I came to things I didn't understand, and wasn't sure if they were for 
users or not.
   I would be glad to start working on that again, if I could get some 
guidance from you, on pages where I have questions.  All I could do is make 
a list, but that might be a starting place for someone else?
   (Note that when I first started working on the FAQ, I don't think 
you were involved yet.  After I announced some of my work on the dev mailing 
list, it was Bryce who said that if I found info in the wiki which really 
should be in the documentation, to make note of it.  It's possible that it's 
not appropriate for some of this to be documented, but that was my best 
understanding at the time.)
   I guess the FAQ would be my best idea as the best place for the 
Roadmap to be linked, if it should not be on the website.  But it would go a 
long way towards preventing users from thinking it's "a done deal" by 
putting a simple sentence at the top of the page, to that effect.  That 
could also be said in the faq.
   I was just about to add those couple of links I've been putting off 
adding.  So shall I make the new faq item for the roadmap, while I'm at it?



- You're quite hardy :)
I've internally categorized most of the Wiki pages as 'outdated' or
'describing a plan, but not necessarily the real implementation'...


Inkscape forums can be quite competitive, as to who gets the right answer. 
Although it's never really verbalized, many are aware!


Where can I look to find out whether a page is outdated or describing a 
plan?



Could you keep track of the kind of info you are looking up, so we can
maybe find a way to include the main components on the website?


I don't remember everything I've looked up, but once was info about the new 
Symbols dialog.  And if the new manual comes out pretty soon, I won't have 
to go to the wiki anymore.
   This is a whole other subject, but I wish we had like a team to 
write the manual, so it wouldn't all be on 1 person's shoulders!  I mean, 
Inkscape really should have it's own "official manual", rather than an 
"official" manual.  And imo, the official manual should be on the website. 
But again, that's another subject.


Thanks,
brynn

--
From: "Maren Hachmann" 
Sent: Friday, June 19, 2015 12:46 PM
To: "Brynn" ; 
Subject: Re: [Inkscape-docs] more prominent link to the wiki?


Hi Brynn,

Am 19.06.2015 um 05:19 schrieb Brynn:

Hi Maren,
   Yes, I understand that the intent for the wiki is more for
developers.  I didn't mean there should be a more prominent link for
users to get to the wiki.  I meant for developers, but others could use
it too.


- Mmh. For devs, the link isn't too hidden, I think:
https://inkscape.org/en/develop/ , fourth paragraph
(but also new devs should not rely on the info in the Wiki being up to
date).

I usually just type 'wik' into my browser's address line, and then
autocompletion kicks in...


   I don't know.  Maybe developers just don't need to go from
website to wiki.  Maybe it's just me.
   But fwiw, what I'm looking for most often is the Release Notes,


- I think that for the next version we could try and get the Release
Notes on the website when they are finalized. They are an important part
of the documentation. This will also make it easier for our translators'
team (who have access to website editing, but most don't have wiki
privileges) to translate them (translating Release Notes is a difficult
task by itself...).


Roadmap,


- The Roadmap is being changed by devs all the time - and users should
not rely on it too much - but unfortunately, they often take it by the
letter, and are then disappointed... It's good info, but I'm a bit
hesitant to put it on the website. Is there a place on the website which
could profit from a direct link to the Roadmap?
(maybe: The Next Release, FAQ, Features?)


and I often search the wiki while trying to answer support
questions from forums.


- You're quite hardy :)
I've internally categorized most of the Wiki pages as 'outda

Re: [Inkscape-docs] more prominent link to the wiki?

2015-06-19 Thread Maren Hachmann
Hi Brynn,

Am 19.06.2015 um 05:19 schrieb Brynn:
> Hi Maren,
>Yes, I understand that the intent for the wiki is more for
> developers.  I didn't mean there should be a more prominent link for
> users to get to the wiki.  I meant for developers, but others could use
> it too.

- Mmh. For devs, the link isn't too hidden, I think:
https://inkscape.org/en/develop/ , fourth paragraph
(but also new devs should not rely on the info in the Wiki being up to
date).

I usually just type 'wik' into my browser's address line, and then
autocompletion kicks in...

>I don't know.  Maybe developers just don't need to go from
> website to wiki.  Maybe it's just me.
>But fwiw, what I'm looking for most often is the Release Notes,

- I think that for the next version we could try and get the Release
Notes on the website when they are finalized. They are an important part
of the documentation. This will also make it easier for our translators'
team (who have access to website editing, but most don't have wiki
privileges) to translate them (translating Release Notes is a difficult
task by itself...).

> Roadmap, 

- The Roadmap is being changed by devs all the time - and users should
not rely on it too much - but unfortunately, they often take it by the
letter, and are then disappointed... It's good info, but I'm a bit
hesitant to put it on the website. Is there a place on the website which
could profit from a direct link to the Roadmap?
(maybe: The Next Release, FAQ, Features?)

> and I often search the wiki while trying to answer support
> questions from forums.

- You're quite hardy :)
I've internally categorized most of the Wiki pages as 'outdated' or
'describing a plan, but not necessarily the real implementation'...
Could you keep track of the kind of info you are looking up, so we can
maybe find a way to include the main components on the website?

> And for the latter, this is especially more for
> the new-in-0.91-features, because the manual hasn't been updated, and a
> lot of the new features are explained in the wiki.  Once the manual is
> updated, I won't be in the wiki as much.

- Tav told me he'd take care of this soon. But it's an awful lot of work
(so many new features ;) ), so it may still take a while.

>(There IS a lot of user-focused stuff in the wiki!  I started to
> work on some of it, thinking maybe it could be updated and moved to the
> website, like I did with the faq.  But almost all of it is over my head.
>I did make a list of the ones that are referenced in the faq,
> hoping to at least get that much transferred over.  

- Could you share that list?

But afaik, no one
> has updated them or moved to the website.)

Kind regards,
 Maren

> 
> Thanks,
> brynn
> 
> --
> From: "Maren Hachmann" 
> Sent: Wednesday, June 17, 2015 12:26 PM
> To: 
> Subject: Re: [Inkscape-docs] more prominent link to the wiki?
> 
>> Am 17.06.2015 um 07:31 schrieb Brynn:
>>> Hi Friends,
>>> This might be just me, but I find myself needing to browse from
>>> the
>>> website to the wiki fairly often.  Of course I have a Favorite/Bookmark
>>> for
>>> it.  But I wonder if a link to the wiki should be easier to find on the
>>> website?
>>
>> Hi Brynn,
>>
>> depends a bit on what the Wiki is intended for.
>> Is it for learning?
>>
>> I understood it more to be a site where the devs exchange their ideas.
>> Most of the info there is outdated, and not regularly refreshed, or only
>> important to developers - beside the Release notes, which live there,
>> because we didn't carry them over to the website after they were
>> finished (and which the devs may find easier to edit in the Wiki than on
>> the web site - at least it allows to insert SVG as images...).
>>
>> What are your use cases?
>> Which of the info in the Wiki should be accessible more easily?
>>
>> Regards,
>> Maren
>>
>>> Usually I open the Learn page, and use the link near the bottom
>>> of
>>> the page.  Anyway, just a thought I wanted to share.  And I wonder what
>>> others might think about it.  Maybe that Learn page link is enough?
>>>
>>> All best,
>>> brynn
>>>
>>>
>>>
>>> --
>>>
>>> ___
>>> Inkscape-docs mailing list
>>> Inkscape-docs@lists.sourceforge.net
>>> https://lists.sourceforge.net/lists/listinfo/inkscape-docs
>>>
>>
>>
>> --
>>
>> ___
>> Inkscape-docs mailing list
>> Inkscape-docs@lists.sourceforge.net
>> https://lists.sourceforge.net/lists/listinfo/inkscape-docs 
> 
> 


--
___
Inkscape-docs mailing list
Inkscape-docs@lists.sourceforge.net
https://lists.sourceforge.net/lists/listinfo/inkscape-docs