* [U-Boot-Users] u-boot wiki and arch-specific details
@ 2008-04-13 23:26 Mike Frysinger
2008-04-14 13:12 ` Detlev Zundel
0 siblings, 1 reply; 5+ messages in thread
From: Mike Frysinger @ 2008-04-13 23:26 UTC (permalink / raw
To: u-boot
we maintain a Blackfin-specific u-boot wiki that goes into quite a bit of
detail, some of which is duplicated with the main u-boot wiki. how do people
feel about extending the u-boot wiki to allow for arch-specific details ?
-mike
-------------- next part --------------
A non-text attachment was scrubbed...
Name: not available
Type: application/pgp-signature
Size: 827 bytes
Desc: This is a digitally signed message part.
Url : http://lists.denx.de/pipermail/u-boot/attachments/20080413/27d9b288/attachment.pgp
^ permalink raw reply [flat|nested] 5+ messages in thread
* [U-Boot-Users] u-boot wiki and arch-specific details
2008-04-13 23:26 [U-Boot-Users] u-boot wiki and arch-specific details Mike Frysinger
@ 2008-04-14 13:12 ` Detlev Zundel
2008-04-14 17:34 ` Mike Frysinger
0 siblings, 1 reply; 5+ messages in thread
From: Detlev Zundel @ 2008-04-14 13:12 UTC (permalink / raw
To: u-boot
Hi Mike,
> we maintain a Blackfin-specific u-boot wiki that goes into quite a bit of
> detail, some of which is duplicated with the main u-boot wiki. how do people
> feel about extending the u-boot wiki to allow for arch-specific details ?
What exactly do you have in mind? I surely don't see any principal
problem here.
It would certainly be valuable to get all U-Boot related info collected
in a central place and have pointers wherever that make sense...
Cheers
Detlev
--
In short: much of our country's [USA] counterterrorism security spending is
not designed to protect us from the terrorists, but instead to protect our
public officials from criticism when another attack occurs.
-- Bruce Schneier
--
DENX Software Engineering GmbH, MD: Wolfgang Denk & Detlev Zundel
HRB 165235 Munich, Office: Kirchenstr.5, D-82194 Groebenzell, Germany
Phone: (+49)-8142-66989-40 Fax: (+49)-8142-66989-80 Email: dzu at denx.de
^ permalink raw reply [flat|nested] 5+ messages in thread
* [U-Boot-Users] u-boot wiki and arch-specific details
2008-04-14 13:12 ` Detlev Zundel
@ 2008-04-14 17:34 ` Mike Frysinger
2008-04-17 14:50 ` Detlev Zundel
0 siblings, 1 reply; 5+ messages in thread
From: Mike Frysinger @ 2008-04-14 17:34 UTC (permalink / raw
To: u-boot
On Monday 14 April 2008, Detlev Zundel wrote:
> > we maintain a Blackfin-specific u-boot wiki that goes into quite a bit of
> > detail, some of which is duplicated with the main u-boot wiki. how do
> > people feel about extending the u-boot wiki to allow for arch-specific
> > details ?
>
> What exactly do you have in mind? I surely don't see any principal
> problem here.
>
> It would certainly be valuable to get all U-Boot related info collected
> in a central place and have pointers wherever that make sense...
from my reading of the wiki, it's more of a technical/command reference than a
guide. the wiki we maintain is geared to be more of a guide. i think the
two can be merged, i just dont want to convert things only to find out people
dont want to take it that direction.
-mike
-------------- next part --------------
A non-text attachment was scrubbed...
Name: not available
Type: application/pgp-signature
Size: 827 bytes
Desc: This is a digitally signed message part.
Url : http://lists.denx.de/pipermail/u-boot/attachments/20080414/e371cb7b/attachment.pgp
^ permalink raw reply [flat|nested] 5+ messages in thread
* [U-Boot-Users] u-boot wiki and arch-specific details
2008-04-14 17:34 ` Mike Frysinger
@ 2008-04-17 14:50 ` Detlev Zundel
2008-04-17 18:01 ` Mike Frysinger
0 siblings, 1 reply; 5+ messages in thread
From: Detlev Zundel @ 2008-04-17 14:50 UTC (permalink / raw
To: u-boot
Hi Mike,
> On Monday 14 April 2008, Detlev Zundel wrote:
>> > we maintain a Blackfin-specific u-boot wiki that goes into quite a bit of
>> > detail, some of which is duplicated with the main u-boot wiki. how do
>> > people feel about extending the u-boot wiki to allow for arch-specific
>> > details ?
>>
>> What exactly do you have in mind? I surely don't see any principal
>> problem here.
>>
>> It would certainly be valuable to get all U-Boot related info collected
>> in a central place and have pointers wherever that make sense...
>
> from my reading of the wiki, it's more of a technical/command reference than a
> guide. the wiki we maintain is geared to be more of a guide. i think the
> two can be merged, i just dont want to convert things only to find out people
> dont want to take it that direction.
Just to be clear, we are discussing the DULG wiki, right?
I agree that in the current state the documentation is more a reference
but IIRC that wasn't really a conscious design decision. It simply
turned out this way in the end.
So I do not see any general problem in adding "guide style" sections in
there. Maybe then most of the current documentation can then be shifted
to a "commands reference" section.
One problem I see though is how to correctly adapt such sections to the
board specific nature of the DULG. Hopefully we can get away with
mostly generic text passages and only a few ifdefs. It would be very
helpful to know more concrete plans (outline!) to think further about
these implications.
Cheers
Detlev
--
Applied mathematicians do it by computer simulation.
--
DENX Software Engineering GmbH, MD: Wolfgang Denk & Detlev Zundel
HRB 165235 Munich, Office: Kirchenstr.5, D-82194 Groebenzell, Germany
Phone: (+49)-8142-66989-40 Fax: (+49)-8142-66989-80 Email: dzu at denx.de
^ permalink raw reply [flat|nested] 5+ messages in thread
* [U-Boot-Users] u-boot wiki and arch-specific details
2008-04-17 14:50 ` Detlev Zundel
@ 2008-04-17 18:01 ` Mike Frysinger
0 siblings, 0 replies; 5+ messages in thread
From: Mike Frysinger @ 2008-04-17 18:01 UTC (permalink / raw
To: u-boot
On Thursday 17 April 2008, Detlev Zundel wrote:
> Hi Mike,
>
> > On Monday 14 April 2008, Detlev Zundel wrote:
> >> > we maintain a Blackfin-specific u-boot wiki that goes into quite a bit
> >> > of detail, some of which is duplicated with the main u-boot wiki. how
> >> > do people feel about extending the u-boot wiki to allow for
> >> > arch-specific details ?
> >>
> >> What exactly do you have in mind? I surely don't see any principal
> >> problem here.
> >>
> >> It would certainly be valuable to get all U-Boot related info collected
> >> in a central place and have pointers wherever that make sense...
> >
> > from my reading of the wiki, it's more of a technical/command reference
> > than a guide. the wiki we maintain is geared to be more of a guide. i
> > think the two can be merged, i just dont want to convert things only to
> > find out people dont want to take it that direction.
>
> Just to be clear, we are discussing the DULG wiki, right?
is there any other worth talking about :)
> I agree that in the current state the documentation is more a reference
> but IIRC that wasn't really a conscious design decision. It simply
> turned out this way in the end.
>
> So I do not see any general problem in adding "guide style" sections in
> there. Maybe then most of the current documentation can then be shifted
> to a "commands reference" section.
OK
> One problem I see though is how to correctly adapt such sections to the
> board specific nature of the DULG. Hopefully we can get away with
> mostly generic text passages and only a few ifdefs. It would be very
> helpful to know more concrete plans (outline!) to think further about
> these implications.
so talking to some people on our side and i realized i forgot about a lame
(but important) aspect. we need to retain full copyright over our docs. we
license it all under a non commercial creative commons license, but sometimes
we get customer requests to include portions of our docs into their work but
under their own rules. if i were to merge the our wiki with the DULG one, we
couldnt in good faith continue that practice. so the wiki's will have to
remain sep, but i can push content into the public one to improve it, just
not vice versa.
-mike
-------------- next part --------------
A non-text attachment was scrubbed...
Name: not available
Type: application/pgp-signature
Size: 827 bytes
Desc: This is a digitally signed message part.
Url : http://lists.denx.de/pipermail/u-boot/attachments/20080417/e86a8447/attachment.pgp
^ permalink raw reply [flat|nested] 5+ messages in thread
end of thread, other threads:[~2008-04-17 18:01 UTC | newest]
Thread overview: 5+ messages (download: mbox.gz follow: Atom feed
-- links below jump to the message on this page --
2008-04-13 23:26 [U-Boot-Users] u-boot wiki and arch-specific details Mike Frysinger
2008-04-14 13:12 ` Detlev Zundel
2008-04-14 17:34 ` Mike Frysinger
2008-04-17 14:50 ` Detlev Zundel
2008-04-17 18:01 ` Mike Frysinger
This is an external index of several public inboxes,
see mirroring instructions on how to clone and mirror
all data and code used by this external index.