-BEGIN PGP SIGNED MESSAGE-
Hash: SHA1
Am 04.07.2012 00:04, schrieb Aurélien Gâteau:
Le mardi 3 juillet 2012 18:24:41 Ingo Malchow a écrit :
In an ideal world we could really work around such issues with
some semi-automated ways. Just an idea: Those who do like the
idea of doing a
[: Aurélien Gâteau :]
I know at least one wiki which is git-based: [...]
[: Ingo Malchow :]
[...]
Additionally we will loose support for quite some plugins, most notably
the translate extension, which is integral part of this entire discussion.
So we would be back at manually copying the
On Sunday 1 July 2012 09:49:11 Kevin Ottens wrote:
[...]
My opinion is that I would love to go for it, and if over time that turns
out to be a problem, we could ship a dump of the relevant wiki content
along the application. It'd be used as fallback if the wiki cannot be
reached online.
Le lundi 2 juillet 2012 07:01:06 Inge Wallin a écrit :
Now, the suggestion was to move to a wiki instead
Advantages:
1. Easier to find the documentation for potential writers.
2. (Supposedly) easier to edit [Personally I'm not sure that editing
advanced wiki markup is easier than docbook]
-BEGIN PGP SIGNED MESSAGE-
Hash: SHA1
Am 03.07.2012 14:00, schrieb Aurélien Gâteau:
Le lundi 2 juillet 2012 07:01:06 Inge Wallin a écrit :
Now, the suggestion was to move to a wiki instead
Advantages: 1. Easier to find the documentation for potential
writers. 2. (Supposedly) easier
Le mardi 3 juillet 2012 15:18:37 Ingo Malchow a écrit :
-BEGIN PGP SIGNED MESSAGE-
Hash: SHA1
Am 03.07.2012 14:00, schrieb Aurélien Gâteau:
Le lundi 2 juillet 2012 07:01:06 Inge Wallin a écrit :
Now, the suggestion was to move to a wiki instead
Advantages: 1. Easier to find
-BEGIN PGP SIGNED MESSAGE-
Hash: SHA1
Am 03.07.2012 18:07, schrieb Aurélien Gâteau:
Le mardi 3 juillet 2012 15:18:37 Ingo Malchow a écrit :
-BEGIN PGP SIGNED MESSAGE- Hash: SHA1
Am 03.07.2012 14:00, schrieb Aurélien Gâteau:
Le lundi 2 juillet 2012 07:01:06 Inge Wallin a
Le mardi 3 juillet 2012 18:24:41 Ingo Malchow a écrit :
In an ideal world we could really work around such issues with some
semi-automated ways.
Just an idea:
Those who do like the idea of doing a manual in a online wiki could
just teach their respective users how to properly format their
On Sunday 01 July 2012 Jul, Yuri Chornoivan wrote:
Hi,
Just a minor remarks on using UserBase for documentation.
1. It does not matter where you *do not* write your documentation.
New Krita manual was started 5-01-2010 [1]. For now, it is not ready even
at 1/10 level. The activity is
On Sunday 01 July 2012 Jul, Anne Wilson wrote:
I'm not subscribed to this list, so please cc me in any replies.
Sort of proves my point that Mirko is right and that we need a KDE-wide mailing
list for all contributors.
...
Boud - I'm not arguing, but is email notification essential? Maybe
Hello,
On Sunday 1 July 2012 08:02:28 Boudewijn Rempt wrote:
I'm actually not sure kde-core-devel is the right list... But the e.V.
mailing list certainly isn't, and we don't seem to have any place for
discussions that affect KDE as a whole.
Well, I think nowadays the name of kde-core-devel
On Sunday 1 July 2012 09:21:08 Albert Astals Cid wrote:
El Diumenge, 1 de juliol de 2012, a les 08:02:28, Boudewijn Rempt va
escriure:
I'm actually not sure kde-core-devel is the right list... But the e.V.
mailing list certainly isn't, and we don't seem to have any place for
discussions
On Sunday, July 01, 2012 09:21:08 AM Albert Astals Cid wrote:
I disagree, as a matter of fact, I don't have internet connection in the
room in my hostel, so if i had a need to use krita I'd need to read its
manual (since my painting/drawing skills are null) and i'd be not happy to
discover I
El Diumenge, 1 de juliol de 2012, a les 09:49:11, Kevin Ottens va escriure:
On Sunday 1 July 2012 09:21:08 Albert Astals Cid wrote:
El Diumenge, 1 de juliol de 2012, a les 08:02:28, Boudewijn Rempt va
escriure:
I'm actually not sure kde-core-devel is the right list... But the e.V.
Hi,
Am Sonntag, 1. Juli 2012, 09:21:08 schrieb Albert Astals Cid:
El Diumenge, 1 de juliol de 2012, a les 08:02:28, Boudewijn Rempt va
escriure:
In any case, Ingo Malchow said in his blog
(http://blog.neverendingo.de/?p=125)
We have a great userbase.kde.org but developers don’t use it
On 07/01/2012 07:02 AM, Boudewijn Rempt wrote:
After yesterday's discussion where David said that for frameworks/qt5 the help
center invocation is actually one of the trickier things, I'm giving this out
for consideration for other app developers...
Over at Konversation we've likewise
On Sunday 01 July 2012 Jul, Eike Hein wrote:
On 07/01/2012 07:02 AM, Boudewijn Rempt wrote:
After yesterday's discussion where David said that for frameworks/qt5 the
help center invocation is actually one of the trickier things, I'm giving
this out for consideration for other app
On Sunday 1 July 2012 10:17:21 Albert Astals Cid wrote:
El Diumenge, 1 de juliol de 2012, a les 09:49:11, Kevin Ottens va escriure:
More seriously, I think we shouldn't loose perspective here. Yes, you're
right, it *can* happen, but Boudewijn is also right, it's becoming rare
situation.
On Sunday 01 July 2012 Jul, Kevin Ottens wrote:
And i'm going to be a pain here, but i do not agree userbase scale better
either.
Let's see Krita manual at http://userbase.kde.org/Krita it's translated to 7
languages only two of them being at 100%
Now let's see KMail manual at
On Sunday 01 July 2012 Jul, Boudewijn Rempt wrote:
On Sunday 01 July 2012 Jul, Eike Hein wrote:
On 07/01/2012 07:02 AM, Boudewijn Rempt wrote:
After yesterday's discussion where David said that for frameworks/qt5 the
help center invocation is actually one of the trickier things, I'm
2012/7/1 Eike Hein h...@kde.org:
Ultimately Albert isn't wrong with his concern, but the reality
seems to be that we just can't get our act together on the
offline documentation while maintaining the wiki comes a lot
easier to us. And it's better to have wiki documentation than
no good
Hi,
On Sunday, July 01, 2012 09:21:08 AM Albert Astals Cid wrote:
El Diumenge, 1 de juliol de 2012, a les 08:02:28, Boudewijn Rempt
I'm not concerned that users cannot access the help when they are
off-line. That's a vanishingly rare situation these days
I disagree, as a matter of fact, I
On 07/01/2012 07:02 AM, Boudewijn Rempt wrote:
After yesterday's discussion where David said that for
frameworks/qt5 the help center invocation is actually one of the
trickier things, I'm giving this out for consideration for other
app developers...
Over at Konversation we've likewise
On 07/01/2012 01:35 PM, Boudewijn Rempt wrote:
I just got that :-). I'm very happy with it, but Eike is right that it probably
wouldn't scale, being a poller. It's really something that needs to be fixed in
the wiki system, so we can get a mail for every change to a manual done in the
wiki.
Am Sonntag, 1. Juli 2012, 13:14:19 schrieb Kevin Ottens:
On Sunday 1 July 2012 10:17:21 Albert Astals Cid wrote:
El Diumenge, 1 de juliol de 2012, a les 09:49:11, Kevin Ottens va
escriure:
More seriously, I think we shouldn't loose perspective here. Yes,
you're right, it *can* happen,
написане Sun, 01 Jul 2012 10:49:11 +0300, Kevin Ottens er...@kde.org:
On Sunday 1 July 2012 09:21:08 Albert Astals Cid wrote:
El Diumenge, 1 de juliol de 2012, a les 08:02:28, Boudewijn Rempt va
escriure:
I'm actually not sure kde-core-devel is the right list... But the e.V.
mailing list
-BEGIN PGP SIGNED MESSAGE-
Hash: SHA1
Am 01.07.2012 13:14, schrieb Kevin Ottens:
On Sunday 1 July 2012 10:17:21 Albert Astals Cid wrote:
El Diumenge, 1 de juliol de 2012, a les 09:49:11, Kevin Ottens va
escriure:
More seriously, I think we shouldn't loose perspective here.
Yes,
El Diumenge, 1 de juliol de 2012, a les 14:37:44, Alexander Dymo va escriure:
2012/7/1 Eike Hein h...@kde.org:
Ultimately Albert isn't wrong with his concern, but the reality
seems to be that we just can't get our act together on the
offline documentation while maintaining the wiki comes a
On Sunday 1 July 2012 14:49:59 Ingo Malchow wrote:
Actually no need to. Translations can already be exported/imported as
po files. One of the benefits of the translate extension (which was
highlighted today in a talk at akademy ;) And docbook export is also
something that is being tested. It
-BEGIN PGP SIGNED MESSAGE-
Hash: SHA1
I'm not subscribed to this list, so please cc me in any replies.
This thread was pointed out to me, and I'd like to comment on some of
the points raised.
Off-line documentation -
There is an extension, Collections, which allows users to select
-BEGIN PGP SIGNED MESSAGE-
Hash: SHA1
Am 01.07.2012 15:33, schrieb Albert Astals Cid:
El Diumenge, 1 de juliol de 2012, a les 14:37:44, Alexander Dymo va
escriure:
2012/7/1 Eike Hein h...@kde.org:
Ultimately Albert isn't wrong with his concern, but the
reality seems to be that we
On 07/01/2012 03:28 PM, Anne Wilson wrote:
Eike - there is a Special:RecentChangesLinked - have you explored the
possibility of that working for you?
Visiting a page == polling.
--
Best regards,
Eike Hein
(Many things have been already pointed out, but I'll repeat, to hopefully
frame it a bit more concretely.)
The way I see it, there are really three conceptually independent aspects
here:
1) Documentation should be up to date, promtly reacting to changes in
program features and behavior.
2)
On 07/01/2012 05:45 PM, Chusslove Illich wrote:
_From my viewpoint, that which is on Konversation wiki is not reference
documentation, which you too implied in the preceding text; and not having
reference is completely fine by me, as I mentioned above. Even so, how comes
this existing content on
[: Chusslove Illich :]
[...] Could it be that you are simply driven away by the Docbook's
towering hulk? :)
[: Eike Hein :]
Yes - that's basically what I alluded to re gives you easy preview.
Right, so there are a few ways to think about this.
One is that even wanting a preview when using
Am 01.07.2012 17:45, schrieb Chusslove Illich:
But, when program authors do decide that they want to have reference
documentation, I don't see how any workflow can be technically more
suitable
(easier to write, easier to maintain) than the documentation source
files
residing right with the
Am Sonntag, 1. Juli 2012, 20:33:26 schrieb Martin Gräßlin:
Am 01.07.2012 17:45, schrieb Chusslove Illich:
But, when program authors do decide that they want to have reference
documentation, I don't see how any workflow can be technically more
suitable
(easier to write, easier to maintain)
[: Burkhard Lück :]
That's really crazy [...] similar to Yuri I found it easy to write docbook
markup.
While to me Docbook is simply less bad than other things, so I use Docbook
when I want to document something about software (if I didn't need HTML
pages, I'd use Latex instead). And when
On Sunday, 1. July 2012 10:22:41 Friedrich W. H. Kossebau wrote:
Hi,
Am Sonntag, 1. Juli 2012, 09:21:08 schrieb Albert Astals Cid:
El Diumenge, 1 de juliol de 2012, a les 08:02:28, Boudewijn Rempt va
escriure:
In any case, Ingo Malchow said in his blog
Am Sonntag, 1. Juli 2012, 21:56:16 schrieb Chusslove Illich:
[: Burkhard Lück :]
That's really crazy [...] similar to Yuri I found it easy to write
docbook markup.
While to me Docbook is simply less bad than other things, so I use Docbook
when I want to document something about software
[: Burkhard Lück :]
But what I really don't understand, why a devel writing C/C++ code says
xml is just a form of binary.
Hey, some devel writing Lisp code say C++ is just a form of binary.
Doesn't really matter why.
--
Chusslove Illich (Часлав Илић)
signature.asc
Description: This is a
-BEGIN PGP SIGNED MESSAGE-
Hash: SHA1
Am 01.07.2012 21:56, schrieb Chusslove Illich:
[: Burkhard Lück :] That's really crazy [...] similar to Yuri I
found it easy to write docbook markup.
While to me Docbook is simply less bad than other things, so I use
Docbook when I want to
On 07/01/2012 09:56 PM, Chusslove Illich wrote:
I further argue that, if people who are accustomed to version control find
web-something-thingy (such as wiki) optimal for their documentation writing
workflow, something has gone horribly wrong; and that efficiency of writing
and maintenance, as
[: Chusslove Illich :]
I further argue that, if people who are accustomed to version control
find web-something-thingy (such as wiki) optimal for their documentation
writing workflow, something has gone horribly wrong;
[: Ingo Malchow :]
Sorry, not sure i get you here. Do you mean a certain
-BEGIN PGP SIGNED MESSAGE-
Hash: SHA1
Am 01.07.2012 23:19, schrieb Chusslove Illich:
[: Chusslove Illich :] I further argue that, if people who are
accustomed to version control find web-something-thingy (such
as wiki) optimal for their documentation writing workflow,
something has
On Sunday, July 01, 2012 07:02:28 Boudewijn Rempt wrote:
I'm actually not sure kde-core-devel is the right list... But the e.V.
mailing list certainly isn't, and we don't seem to have any place for
discussions that affect KDE as a whole.
In any case, Ingo Malchow said in his blog
46 matches
Mail list logo
