[wiki] Referencing to Figures

saccade · 2009-01-21 18:11:01

So far.
I didn’t quote the parts I’m answering to (would be a lot of work and would make the post much longer) but I think it is clear enough (at least I hope so).

Let me say:
Of course it would be much simpler not to discuss this whole thing and only leave it to improving the texts – but I think there is a benefit, that shouldn’t be left out.

It seems you’re hard to convince, but I hope I can make clear that it’s not an irrelevant thing I’m after.

(And maybe you have to know the following:
In the first place – in the major half of my existence – I’m a lutheran pastor.
So nails and a bunch of thesis are always handy,
translation (appropriate communication for all) is an affair of my heart,
and I won’t miss a good debate/discussion how to do best,
as well as a good beer,
but I’ll repent gladly if I did something wrong. ;-)

So please be patient with my insisting on keeping a visual approach. I hope I showed, that I can follow and integrate much of the concerns against it.)

Last edited by saccade (2009-01-21 21:27:23)

Destry · 2009-01-23 09:32:19

Hi Saccade,

First, I hope you realize (if at least by the smiley) that when I said “thesis,” it was just some friendly fun.

Second, as I’ve mentioned before, your time and thinking on it all is greatly appreciated. The fact you present your thoughts in a methodical way is evidence to your good intentions. Whether or not we agree on every point is irrelevant. Discussing both sides of an issue to get to a solution is good and welcome.

Third, if your aim turns into a must convince Destry campaign (as gleaned from your last post there), then we are not going to get anywhere. :)

My position (oft said before) is not to instill my will in everything TextBook. My contributions are offered with consideration to wiki users, like anyone’s contributions should be, namely : 1) site admins new to Txp (docs), and 2) people in this community that maintain the wiki (admins/authors). That’s not saying you are not thinking of these audiences, I’m just making it clear what my position is.

I’ll respond to your four points separately to keep it sane. Like I mentioned before, I’m doing several things (and my son just came down with the flu) so be patient as I get to to each one.

(Of course anyone else is welcome — and expected — to add their two cents.)

saccade · 2009-01-23 10:31:32

Hi Destry,

yes of course I realized the fun and my reply as you can see from the last infos good to know (true by the way) I meant my thesis defence no less friendly fun. I think a debate in communication strategy must be a fun thing.

Please don’t think it’s a campaign. It’s just that I appreciate your work and your stringent keeping tracks very much – and think working together is much more fun and much more effective if you (with “you” now I mean every participant, you me and whoever works together) agree on a (thinking- or designing-) concept – even if you won’t do it exactly the same way in your own realm. I even didn’t intentionally concentrate on you , for I described my thoughts to have a good discussion of ways in the community. At least you’re one of the godfathers of Textpattern/TextBook (which I appreciate highly), so I’d like much to be in harmony with your concepts. This is the reason, why “convincing” would mean: My thoughts have gone through a good fire, that burnt down clutter (in each aspect) and left a valuable thing for making the most effective and splendid documentation – and got your “OK”. :-)

An example: Just when you posted the last post, I was working on another point you were concerned: (and I too have to do it between other tasks with higher priority – but decided to try and hopefully finish a thing before it get’s lost in life again as many others)

You said, the red color bullets are “distracting”. That I won’t dismiss easily but take as a serious thing to solve:

OK, I did take it over as a heritage from what I saw on the pages before. And – as an excuse – I’m quite customed to red rubrication :-) – that’s clearly personal. Also it’s the color which isn’t used elsewhere, so it seems to me a appropriate choice.

But you’re right: It is somehow aggressive, it may distract if you get an alarmed feeling with those red points (though I think most readers will soon blend it out in their perception if they don’t use the visual layer).
So I think this is a good critique offering to me to make the visual layer better:

And it gives me another task: Red is distracting – so smite the “dis” – but keep the tracting.

Unfortunately I’m not that fast and first have to make the images, but I will come up with another version.

So your words are highly appreciated, if possible an “OK, (let’s) go that direction” would be very welcome if there is a concept we agree on, but there is no “must convince”.

And of course anyone else is welcome. I would like to hear if this or that part of my thoughts (and images) seems reasonable to others and which thing will have the most support and benefit.

(Edit: New thing moved to a new topic)

(And I hope your son will be well again soon! There are much more important things than design debates – discussion can of course wait.)

Last edited by saccade (2009-01-24 22:03:35)

Destry · 2009-01-23 16:04:13

saccade wrote:

The question if TextBook is a reference, manual or where which of them.

I don’t know what “where which of them” means, but the question is a good one nevertheless. However, I think it should be its own topic thread or it will be buried or hard to follow here where there’s already some meaty dialog taking place.

I recommend starting that thread and then we delete these two posts here. I’ll then reply in that new thread.

Response to image, Point 1 arguments coming up…

Last edited by Destry (2009-01-23 16:04:43)

saccade · 2009-01-29 22:16:41

On “Smite the ‘dis’ and keep the trac(k/t)ing”: ;-)
See now

(Has been a hard week, so new visual approach specimen took a long time.)

Here what I can imagine even better than red rubrication:
More Textpatternish, and I think the same way helpful – but much lesser distraction.

I also tried green but that didn’t apply as good (need to try more different color variations yet).

If you want to see it “live” try this

Last edited by saccade (2009-01-29 22:23:10)

Destry · 2009-01-30 00:21:12

I’m still intending to reply. Promise. Just crazy busy. Response is mostly written, in fact. Just have to finish.

saccade · 2009-01-30 06:28:23

Hi Destry. Absolutely no need to hurry. I don’t want to put pressure on anyone, just do/finish what I promised.

And still: Anyone else with comments on it?
Apart from the question if this approach is adopted/applicable for TextBook, I’d like to know if it is effective/useful for txp-Documentation at all.

Destry · 2009-01-30 13:59:48

saccade wrote:

I’d like to know if it is effective/useful for txp-Documentation at all.

Effective and useful? Yes. The only solution? No. The best solution? Mmmm…no, from my view.

Your ideas are certainly plausible, and again, they are not too different from the general approach I/we used originally, but my position now is not what is just “effective,” but what is damn hard to beat, all things considering. And thos considerations include being effective and usable, sure, but also elimination of admin/author overhead and keeping to conventions to what readers already know and expect.

When we talk about putting graphics inline as markers to topics addressed in large images with many topics, then I think we’ve crossed the line of reducing admin/authoring overhead for the sake of a perceived increase in reader usability; an increase in usability that’s probably not significant enough to warrant the graphic overhead to begin with. (Let’s not forget that wiki pages are printed too, and graphics just make for more overhead there as well.)

But I’m getting carried away…stand by for the response to your first point earlier on. :)

saccade · 2009-01-30 14:13:23

Without touching any other point – just for the pure aesthetices/color/effect feeling:
What looks and feels better – “red” or dark “cheese”?
Is it a step in the right or a better direction (also: without any judgement/decision on any other point)?
Or isn’t it?

Textpattern CMS

Textpattern CMS support forum

#16 2009-01-21 18:11:01

Re: [wiki] Referencing to Figures

#17 2009-01-23 09:32:19

Re: [wiki] Referencing to Figures

#18 2009-01-23 10:31:32

Re: [wiki] Referencing to Figures

#19 2009-01-23 16:04:13

Re: [wiki] Referencing to Figures

#20 2009-01-29 22:16:41

Re: [wiki] Referencing to Figures

#21 2009-01-30 00:21:12

Re: [wiki] Referencing to Figures

#22 2009-01-30 06:28:23

Re: [wiki] Referencing to Figures

#23 2009-01-30 13:59:48

Re: [wiki] Referencing to Figures

#24 2009-01-30 14:13:23

Re: [wiki] Referencing to Figures

Board footer