fedwiki / wiki-server

Federated Wiki client and server in Node.js
Other
153 stars 35 forks source link

How do I use this? #77

Closed rmbishop closed 8 years ago

rmbishop commented 9 years ago

It's not clear to me how to use wiki-node-server outside of using the smallest federated wiki package. Is wiki-node-server itself useful outside of the context of the sfw? If so, what are it's use cases? How do I use it? Some documentation in this regard would be helpful.

WardCunningham commented 9 years ago

It is more that wiki-node-server is ready to step aside for other server implementations that share the same client side code.

These are my notes on moving to, and developing within, the current package structure. http://ward.fed.wiki.org/view/organize-code-in-packages/view/release-process/view/things-to-test

rmbishop commented 9 years ago

Ok, I think I may understand. Please correct me if I'm mistaken.

1)There is no one server package or client package for SFW. Instead, the big idea that SFW is really a set of rules that any server/client pair for SFW needs to abide by.

2)node-wiki-server is half of one pair for a particular implemenation of SFW. The other half of that pair is wiki-client, which is a dependency of node-wiki-server.

3)The name wiki-client as seen in node_modules of node-wiki-server may be a bit of misdirection, as what wiki-client is, is really "node-wiki-client", which is the other half of the server/client pair for the node implemenation of SFW.

Thanks,

Ryan

On Sat, Nov 22, 2014 at 7:33 PM, Ward Cunningham notifications@github.com wrote:

It is more that wiki-node-server is ready to step aside for other server implementations that share the same client side code.

These are my notes on moving to, and developing within, the current package structure.

http://ward.fed.wiki.org/view/organize-code-in-packages/view/release-process/view/things-to-test

— Reply to this email directly or view it on GitHub https://github.com/fedwiki/wiki-node-server/issues/77#issuecomment-64102703 .

rmbishop commented 9 years ago

One more thing...isn't a "client" for SFW really a client-facing interface to a server, whereas the browser is the client?

Thanks again,

Ryan

On Sat, Nov 22, 2014 at 10:28 PM, bmk7800 bmk7800@gmail.com wrote:

Ok, I think I may understand. Please correct me if I'm mistaken.

1)There is no one server package or client package for SFW. Instead, the big idea that SFW is really a set of rules that any server/client pair for SFW needs to abide by.

2)node-wiki-server is half of one pair for a particular implemenation of SFW. The other half of that pair is wiki-client, which is a dependency of node-wiki-server.

3)The name wiki-client as seen in node_modules of node-wiki-server may be a bit of misdirection, as what wiki-client is, is really "node-wiki-client", which is the other half of the server/client pair for the node implemenation of SFW.

Thanks,

Ryan

On Sat, Nov 22, 2014 at 7:33 PM, Ward Cunningham <notifications@github.com

wrote:

It is more that wiki-node-server is ready to step aside for other server implementations that share the same client side code.

These are my notes on moving to, and developing within, the current package structure.

http://ward.fed.wiki.org/view/organize-code-in-packages/view/release-process/view/things-to-test

— Reply to this email directly or view it on GitHub https://github.com/fedwiki/wiki-node-server/issues/77#issuecomment-64102703 .

WardCunningham commented 9 years ago

The "smallest" federated wiki was an experiment proposed for a weekend hackfest. It stretched out for a year and a half and was successful enough that we reorganized the project as simply federated wiki. And move the single original repository to the current setup with dozens. But the important thing is there is nothing necessarily centralized about the project. As a consequence there is no single welcome page that defines how everything is going to be. But here are some of my observations from near the de facto center of the project:

http://ward.fed.wiki.org/view/diversity-in-service/view/laptop-server/video.fed.wiki.org/sfw-history-animated

rmbishop commented 9 years ago

thank you

Ryan

On Sun, Nov 23, 2014 at 12:11 AM, Ward Cunningham notifications@github.com wrote:

The "smallest" federated wiki was an experiment proposed for a weekend hackfest. It stretched out for a year and a half and was successful enough that we reorganized the project as simply federated wiki. And move the single original repository to the current setup with dozens. But the important thing is there is nothing necessarily centralized about the project. As a consequence there is no single welcome page that defines how everything is going to be. But here are some of my observations from near the de facto center of the project:

http://ward.fed.wiki.org/view/diversity-in-service/view/laptop-server/video.fed.wiki.org/sfw-history-animated

— Reply to this email directly or view it on GitHub https://github.com/fedwiki/wiki-node-server/issues/77#issuecomment-64108096 .